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KEEP THIS UPDATE NOTICE IN YOUR MANUAL TO MAINTAIN AN UP-TO-DATE 
RECORD OF CHANGES. 

TYPE AND IDENTIFICATION OF DOCUMENTATION CHANGES. 

Five types of changes are used to update documents contained in the TOPS-20 software manuals. 
Change symbols and notations are used to specify where, when, and why alterations were made to 
each update page. The five types of update changes and the manner in which each is identified are 
described in the following table. 



The Following Symbols and/or Notations 

1. Change bar in outside margin; version num- 
ber and change date printed at bottom of 
page. 

2. Change bar in outside margin; change date 
printed at bottom of page. 

3. Change date printed at bottom of page. 



4. Bullet (•) in outside margin; version number 
and change date printed at bottom of page. 

5. Bullet (•) in outside margin; change date 
printed at bottom of page. 



Identify the Following Types of Update Changes 

1 . Changes were required by a new version of 
the software being described. 



2. Changes were required to either clarify or 
correct the existing material. 

3. Changes were made for editorial purposes 
but use of the software is not affected. 

4. Data was deleted to comply with a new ver- 
sion of the software being described. 

5. Data was deleted to either clarify or correct 
the existing material. 
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PREFACE 



This manual is written for the assembly language programmer who is 
already familiar with TOPS-20 monitor calls. For an introductory 
discussion of some basic monitor calls, refer to the TOPS-20 Monitor 
Calls User's Guide . For a more complete description of the monitor 
calls that can be used to perform ARPANET functions, refer also to the 
TOPS-20AN Monitor Calls User's Guide . 

Chapter 1 introduces the conventions to follow when using monitor 
calls, and describes the types of arguments used with the monitor 
calls. Chapter 2 presents the calls related to particular functions 
and tasks, such as using the software interrupt system. Chapter 3 
contains, in alphabetical order, descriptions of all the monitor 
calls. 

Appendix A contains the EBCDIC, ASCII, and SIXBIT collating sequences, 
and conversions between these three character set representations. 
Appendix B is a listing of the system file MONSYM.MAC, which defines 
many of the symbols used in this manual. Appendix C is a listing of 
the system file MACSYM.MAC, which contains symbols and macros useful 
in assembly-language programming. Appendix D is a listing of the 
system file ACTSYM.MAC, which defines the macros and symbols used with 
the USAGE monitor call. 
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CHAPTER 1 
INTRODUCTION 



The TOPS-20 Monito r Calls Reference Manual describes every monitor 
call in the TOPS-20 system. Monitor calls for ARPANET systems and 
DECnet systems are also described. The use of these calls, however, 
is more completely described in the ARPANET Manual and the DECnet 
Manual . 

TOPS-20 monitor calls invoke the TOPS-20 monitor by means of the JSYS 
instruction (op code 104). The UUO-type monitor calls (op codes 
40-77) invoke the TOPS-10 compatibility package, which simulates the 
action of these UUO's in the TOPS-10 monitor. Programs written for 
TOPS-20 should use TOPS-20 monitor calls, not UUO's. 

For easy reference, monitor call descriptions in Chapter 3 are 
arranged alphabetically and presented concisely. This concise format 
begins with the monitor call name and numeric definition, followed by 
a brief description of the monitor call function. The calling 
sequence for the monitor call is next, indicated by statements in the 
format 

ACCEPTS IN ACn: description 

where n is an accumulator number. Following the list of accumulators 
and descriptions of their contents are statements of the form 

RETURNS +1: condition 
+2: condition 

These statements define where control returns, and under what 
conditions, after execution of the monitor call. The statement 
PETURNS+1: means that control returns to the memory location 
immediately following the calling location. The statement RETURNS+2: 
means that control returns to the second memory location after calling 
location . 

Next, there is an optional description of the action taken by the 
monitor call. Finally, a list of possible error mnemonics ends the 
monitor call definition. 



1 . 1 CALLING CONVENTIONS 

Arguments for the monitor call are placed in accumulators (ACs) , then 
the monitor call is executed. The first argument is in AC1, the 
second in AC2, and so forth, up to a maximum of four accumulators. 

Many calls also require an argument block. This is a group of 
contiguous words of memory that contain additional arguments. Tf an 
argument block is required, an AC must contain a pointer to the 
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argument block. See the description of the GTJFN% monitor call for an 
example of the use of argument blocks. 

In addition, arguments in an argument block can point to other 
argument blocks. These other argument blocks can, in turn, contain 
other groups of arguments. For an example of this way of passing many 
arguments to a monitor call, see the description of the GTJFN call in 
Chapter 3. (There are severa] exceptions to this convention; refer 
to the individual descriptions in Chapter 3.) 

Data returned by the execution of a monitor call is often returned in 
the AC's. If a call returns more data than can be held in four AC'S, 
it returns the data to a data block. A pointer to the data block must 
be passed as an argument to the monitor call. Such a pointer can be 
passed in either an AC, or an argument block. 

When using a monitor call in a program, end the name of the call with 
a percent (%) character. This convention helps avoid conflicts 
between monitor call names and symbols defined by your programs. In 
addition, this convention is required by the newer monitor calls 
(those defined in TOPS-20 Release 4 or later). Although older calls 
(those defined before TOPS-20 Release 4) do not require a percent 
character at the end of their names, they will accept one. 



1 . 2 MONITOR CALL ARGUMENTS 

A monitor call argument can be one of the following: 

a word of data 

the memory address word that contains data 

a page number 

a section number 

a byte pointer 

a file handle 

a source (or destination) designator that defines where to 
obtain (or send) data 

a process handle 

a file/process handle 

The following sections describe these arguments. 



1.2.1 Addresses 

On a DECsystem-20 addresses can be one of two types: an 18-bit 
address, or a 30-bit address. TOPS-20 supports 30-bit addressing, but 
provides an address space of 32 (decimal) sections, each of which 
contains 256K words. Thus although 30 bits are used to contain a 
global address, the section number in such an address can be no longer 
than 6 bits, making the largest possible address a total of 23 bits 
long . 
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An 18-bit address is called a section-relative address. With such an 
address you can specify any word in a 256K-word section of memory, but 
you cannot also specify a section number. With a 30-bit, or global, 
address you can reference any word of any section of memory. (Pefer 
to the Hardware Reference Manual for a description of global 
addresses . ) 

TOPS-20 allows you to use 18-bit or 30-bit addresses. Some monitor 
calls require one kind, some the other; some calls accept either 
kind . 

Some monitor calls use only 18 bit to hold an address. These calls 
interpret 18-bit addresses as locations in the current section, the 
same section as that of the code being executed (the same section as 
the user PC.) To form an unambiguous global address, these calls add 
the section number of the PC to the section-relative address. 

Monitor calls that use an entire word for an address can accept either 
18-bit or 30-bit addresses. If the address is 30 bits (the section 
number is not zero), it is a global address. 

If the address is 18 bits (the section number is zero), the monitor 
call acts in one of two ways. If the call existed in Release 4 or 
earlier, it interprets the address as a section-relative address, as 
stated above. But if the call is one of the extended-addressing calls 
(if the call starts with an X), the call interprets the zero in the 
section-number field as indicating section zero. 



1.2.2 Page Numbers 

A TOPS-20 page number can be 9 bits or 18 bits long. A page number 
can refer to either a page of memory, or a page of a disk file. 

The 9-bit number is called a section-relative page number. Such a 
page number can specify any page within a 256K-word section of memory, 
or any page within a 256K section of a file. (A file section is a 
unit of 512 pages within a file. The first page of each such section 
has a page number that is an integer multiple of 512.) 

The left half of a section-relative (18-bit) address can be considered 
to be a section-relative page number. If a monitor call uses only 9 
bits of a word to hold a page number, the monitor considers that page 
to be within the current section. 

Most monitor calls that require page numbers as arguments use at least 
half of a word to contain the page number. Such calls allow you to 
specify an 18-bit, or global, page number. A global page number 
refers to both a section of memory and a page within that section. 
Page 23200, for example, is page 200 in section 23. 



1.2.3 Section Numbers 

A section number is 6 bits long. In a global address, a section 

number occupies bits 6 through 17. Because TOPS-20 supports 40 

(octal) sections of memory, using section numbers larger than 37 
causes an error. 
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1.2.4 Byte Pointers 

Monitor calls accept two kinds of byte pointers as arguments: 
one-word local byte pointers, and one-word global byte pointers. 
One-word local byte pointers work in all sections, but one-word global 
byte pointers cannot be used in section 0. 

The Hardware Reference Manual describes one-word local byte pointers 
in detail. The paragraphs below discuss one-word global byte 
pointers . 

Any monitor calls that accept source/destination designators (See 
Section 1.2.6.) also accept byte pointers, and the bytes can be from 1 
to 36 bits long. SIN and SOUT are examples of such monitor calls. 

If a call cannot accept a source/destination designator, however, that 
call only accepts byte pointers that point to 7-bit bytes. Examples 
of such calls are CACCT and PSOUT. Note, however, that for historical 
reasons some monitor calls accept one-word global byte pointers that 
point to bytes of other lengths. 

TOPS-20 monitor calls do not accept the two-word local byte pointers 
or the two-word global byte pointers described in the Hardware 
Reference Manual. 

Local byte pointers can only point to a byte in the current section. 
This is because they use 18 bits to hold the address of the byte. You 
can use indexing with local byte pointers, however, to point to a byte 
in another section of memory. 

If, for example, AC5 contains a 30-bit address, the following 
instruction generates an indexed local byte pointer in AC2. The 
pointer points to a byte in another section, the section of the 
address in AC5. 

MOVE 2, [POINT 7,0(5)] 

Use of indirect addressing with local byte pointers is discouraged. 

Global byte pointers use 30 bits to hold the address of the byte, thus 
they can point to a byte in any section of memory. One-word global 
byte pointers have the following format: 

! P ! address ! 

Table 1-1 shows how the KL-10 processor interprets the P field. 
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Table 1-1 
P-Field Values for One-word Global Byte Pointers 

P (octal) Byte Size Position of the Fight-Most Bit 

(count, in octal, of the number 
of bits to the right of the 
current pointer position) 

Less than 45 a local byte pointer. 

4 5 6 4 4 

46 6 36 

4 7 6 3 

5 6 2 2 
51 6 14 

5 2 6 6 

53 6 

54 8 44 

55 8 34 

56 8 24 

57 8 14 

60 8 4 

61 7 44 

6 2 7 3 5 

63 7 26 

64 7 17 

65 7 10 

66 7 1 

67 9 44 

70 9 33 

71 9 22 

7 2 9 11 

73 9 

74 18 44 
7 5 18 2 2 

76 18 

77 unused (causes an illegal instruction trap) 

You cannot use indexing or indirect addressing with one-word global 
byte pointers. In addition, you cannot use one-word global byte 
pointers in section 0. 



1.2.5 File Handles and File Designators 

A file handle is also known as a job file number, or JFN. It is an 
18-bit number that, within the context of a job, uniquely identifies a 
file. 

An indexable file handle, or full-word JFN, has a JFN in the right 

half and flags in the left half. This file handle is useful for 

handling several files in sequence. See Section 2.2.3 for a more 
complete discussion of file handles. 
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1.2.6 Source/Destination Designators 

Some monitor calls act upon bytes or strings of bytes, or transfer 

bytes from one place to another. Such calls often use 

source/destination designators to identify where the bytes are sent or 
obtained . 

A source/destination designator is a 36-bit quantity that can have the 
formats given in Table 1-2. The paragraphs following the table 
describe each designator. Note that byte pointers are also 
source/destination designators. 



Table 1-2 
Source/Destination Designators 



Symbol 


Left Half 


Pight Half 


Meaning 


(none) 





JFN 


a job file number. The JFN 
is the job's handle on a 
file, and is assigned with 
the GTJFN monitor call. 
(Refer to Section 2.2.3.) 


.PRIIN 





100 


primary input designator 


•PPIOU 





101 


primary output designator 


.NULIO 





377777 


null designator 


.TTDES 





4xxxxx 


universal terminal designator 


.CTTRM 





mm 


the process's controlling 
terminal 


.DVDES 


6xxxxx 


xxxxxx 


universal device designator 
(for use only in section 0) 




777777 


address 


implicit byte pointer. 
TOPS-20 changes left half to 
440700. (Refer to Sections 
1.2.4 and 1.2.6.2.) 




777777 


111111 


universal default 




5 x x x x x 


xxxxxx 


numeric value 


Note: Tl 
is expec 
GNJFN " ne^ 


ie designators 
ted. You canr 
;er assign 1 Of 


3 .PPIIN and .E 
lot assion their 
) or 101 I 


P.IOU are legal wherever a JFN 
as JFN's, however. GTJFN and 



The most commonly used source/destination designators are: 

1. A JFN, identifying a particular file. Before a JFN can be 
used, it must be obtained by means of the GTJFN monitor call. 
(See Section 2.2.3.) 

2. The primary input and output designators. (Refer to Section 
2.2.9.) These designators are the ones recommended for use in 
referring to the job's controlling terminal because they can 
be changed to cause terminal input and/or output to be taken 
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from and/or sent to a file. The controlling terminal 
designator .CTTRM (0,-1) cannot be redirected in this way, 
and its use is not recommended in normal situations. 

3. A byte pointer to the beginning of the string being read or 
wr i tten. 



1.2.6.1 File Designator - A file designator indicates that I/O to be 
done by the monitor call is to be done as though to a terminal. A 
file designator can be any of the following: .PRIIN, .PPIOU, .NULIO, 
.TTDES, .CTTRM, or .DVDES. 



1.2.6.2 Byte Pointers and ASCII Strings - Many monitor calls deal 
specifically with ASCII strings. The following conventions apply to 
such strings. 

1. A file designator can be used if the file is in 7-bit ASCII 
format. This is the usual format for text files. 

2. One of the following is used to designate a string in the 
caller's address space: 

a. -1,,ADR to designate a 7-bit ASCII string beginning in 
the leftmost byte of ADR. This is for convenience, 
making HRROI 1,ADR functionally equivalent to 
MOVE 1, [POINT 7, ADR] . 

b. A byte pointer with a byte size of 7 bits. If the byte 
size is not 7 bits, the results might be incorrect. This 
is because monitor calls use the ILDB and IDPB 
instructions to reference byte strings, and do no 
additional checking to see that the data is in the 
correct format. Note, however, that for historical 
reasons some monitor calls accept byte pointers with byte 
sizes larger or smaller than 7 bits. 

NOTE 

Unless otherwise noted, the term "byte 
pointer" is used in this manual to 
indicate an ILDB/IDPB byte pointer that 
points to an ASCIZ string. The 
following example generates such a byte 
pointer : 

POINT 7, [ASCIZ/character string/] 

The term "pointer" is usually used to 
refer to an address, except in 
discussions that must make repeated 
references to the term "byte pointer". 
In the latter case, some of the 
occurrences of "byte pointer" will be 
shortened to "pointer" to avoid 
monotonous repetition. In these cases, 
however, it will be clear from the 
context that "pointer" implies "byte 
pointer" . 
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Normally, monitor calls assume that ASCII strings are terminated with 
a byte containing zeroes (an ASCIZ string) . A few calls terminate on 
other ASCII characters because of context (the NIN call, for example), 
and some optionally accept an explicit byte count or allow you to 
determine the terminating byte. These latter calls (SIN and SOUT 
calls, for example) are generally those that can handle non-ASCII 
strings and byte sizes other than 7 bits. 

After a monitor call is used to read a string, the source byte pointer 
argument is updated such that an ILDB would read the character 
following the terminating character; an LDB would reread the 
terminating character. 

After a monitor call is used to write a string, the destination byte 
pointer argument is updated to point to the character following the 
last nonnull character written. If there is room, a null byte is 
appended to the string, but the byte pointer returned is such that an 
IDPB will overwrite the null. 



1.2.6.3 Special Designators - The universal default designator of -1 
is used to indicate the current designator, such as the current job or 
the connected directory. For example, the GETJI monitor call accepts 
an argument of -1 as the designator for the current job. 



1.2.6.4 Numeric Designators - The designator 5xxxxx xxxxxx (where a 
numeric value is in bits 3-35) is used to supply a numeric designator 
as an argument to a call. Numeric designators are used to identify 
account numbers, directory numbers, user numbers, and the like. The 
DIRST monitor call, for example, accepts a user number as 5B2+33-bit 
number . 



1.2.7 Device Designator 

Many monitor calls dealing with devices (refer to Section 2.4) take a 
device designator as an argument. A device designator can be either 

LH: .DVDES(600000)+device type number 

RH: unit number for devices that have units, arbitrary code for 

structures, or -1 for nonstr ucture devices that do not have 

units 

or 

LH: 

PH: .TTDES (400000) + terminal number, or . CTTRM (777777) for 
controlling terminal 

Thus, terminals can be represented in two ways; the second way is 
provided for compatibility with the source/destination designator. 

Because designators for structures contain an arbitrary code, these 
designators must always be obtained from the monitor (by means of the 
STDEV call) and cannot be created by the program. 

Section 2.4 describes the various devices and their type numbers. 
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400000 


.FHSLF 


400000+n 


- 


-1 


. FHSUP 


-2 


. FHTOP 


-3 


.FHSAI 


-4 


.FHINF 


-5 


.FHJOB 
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1.2.8 Process Handles 

Several monitor calls accept an 18-bit argument called a process 
handle. The following fork handles are defined within the context of 
a job. 

Value Symbol Meaning 

current process 

process n , relative to the current process 

superior process 

top-level process 

current process and all of its inferiors 

all of the current process 1 inferiors 

all processes in the job 

Use of the superior process argument (.FHSUP) is legal only if the 
process has the superior process access capability (SC%SUP) enabled in 
its capability word. Meaningful operations may usually be performed 
with the top level process argument (.FHTOP) only if the process has 
WHEEL or OPERATOR capability enabled (SC%WHL or SC%OPP) in its 
capability word. Pefer to Section 2.7.1 for information on the 
capability word. 

Process handles in the range 400001 to 400777 are called relative 
process handles, and are generated by the monitor to refer to specific 
processes. (See the CFORK monitor call description.) These handles 
are valid only within the context of the process to which they are 
given. Thus, they may not be passed between processes. GFRKH may be 
used to convert process handles for use by another process. 



1.2.8.1 Process/File Handle - Some monitor calls accept an 18-bit 
argument called a process/file handle. This handle is either a 
process handle (as defined in Section 1.2.8), or a JFN. 

Note that string pointers and terminal identifiers cannot be used in 
this context. This is not a limitation, however, because the 
operations that use the process/file handle are used for changing page 
maps. Such operations are not meaningful for string pointers or 
terminals . 



1.3 SYSTEM DATE AND TIME 

The internal system date and time is a 36-bit quantity. It can be 
passed to a monitor call as an argument, or returned as a value. The 
internal date- 1 and- | time word has the following format: 

day, , fraction 

where day is the number of days since November 18, 1858, and fraction 
is the fractional part of the day elapsed since midnight, Greenwich 
Mean Time. The fraction is the numerator of a fraction that has a 
denominator of 2**18. Thus the fraction 

fraction/2**18 

represents the portion of the diy elapsed since midnight. This format 
conforms to the Smithsonian Astronomical Date Standard. 
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Because the time is stored as Greenwich Mean Time, the monitor adds 
the value of the TIMEZONE offset to the internal date and time to 
obtain your local time. The TIMEZONE offset is specified in 
<SYSTEM>CONFIG.CMD. (See the Installation Guide for more information 
on the TIMEZONE offset.) 

Monitor calls convert local dates and times to internal dates and 
times, and internal dates and times to local dates and times. Refer 
to Section 2.9.2 for more information about the date and time 
conversion . 



1.4 PROCESSING ERRORS 

After execution of a monitor call, program control returns to the 
calling program at one of two locations. The +2 return indicates 
successful completion of the monitor call. The +1 return is often 
used to indicate failure of the monitor call to perform its intended 
function. (Refer to Chapter 3 for specifics on the returns possible 
from each monitor call.) 

When a failure occurs during the execution of a monitor call, the 
monitor stores an error code. The error code indicates the cause of 
the failure. This error code is usually stored in the right half of 
AC1, but can also be stored in the monitor's data base. In either 
case, you can obtain the message associated with the error by using 
the GETER or ERSTR calls. 

Some monitor calls, however, have only a single return (+1) , to the 
instruction following the call. This instruction is executed upon 
successful completion of the call. 

When an error occurs during execution of single-return call, the 
monitor examines that next instruction. If it is a JUMP instruction, 
and the AC field is 16 or 17, the monitor transfers control to the 
address specified in the JUMP instruction. 

If the instruction following the call is not a JUMP instruction, the 
monitor generates a software interrupt. The calling program can 
process the interrupt by means of the software interrupt system. If 
the program is not prepared to process the interrupt, the process is 
usually terminated, and a message is output. (Refer to Section 2.6.) 

Instead of a JUMP instruction, you can use one of the following 
symbols as the instruction following the call: 

ERJMP address 
ERCAL address 

These symbols correspond to JUMP 16, and JUMP 17, respectively, which 

are machine no-ops. Because ERJMP and ERCAL are symbols that are 

defined in MONSYM, you must place a SEARCH MONSYM statement at the top 

of your program. (See the Assembler Manual for a description of the 
SEARCH pseudo-op.) 

When an ERJMP is used, the monitor simulates a 

JRST address 

instruction. This transfers control permanently to the effective 
address. The address should be the starting address of an 
error-processing routine. To return control to the program after 
processing the monitor call error, the error routine must include a 
JPST instruction. 
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When an ERCAL is used, the monitor simulates a 

PUSHJ 17, address 

instruction. This is a subroutine call. To return control to the 
code that follows the unsuccessful monitor call, the subroutine must 
include a 

POPJ 17, 

instruction. Note that ERCAL requires accumulator 17 to be set up as 
a pushdown pointer. 

The ERJMP or ERCAL instruction can be used with all monitor calls 
independent of whether the call has one or two returns. These 
instructions allow you to process an error without using the software 
interrupt system. In fact, use of these symbols overrides the 
software interrupt system. 

An EPJMP or ERCAL may also be used following a machine instruction, 
and will trap for the following conditions: 

1. Illegal instruction 

2. Illegal memory read 

3. Illegal memory write 

4. Pushdown list overflow 

The ERJMP or EPCAL executes if it is either the next instruction 
following a monitor call that fails, or the next instruction following 
a machine instruction that generates the errors shown above; 
otherwise, it is a no-op. 

NOTE 

If an EPJMP or ERCAL executes op an 
error from a monitor call, the contents 
of any AC ' s that would normally contain 
an error code may be unreliable. Using 
the GETER monitor call is the sure way 
to obtain the error code in such a case. 



1.5 CONVENTIONS USED IN THIS MANUAL 

1.5.1 Number Bases 

Except where otherwise noted, numbers used in this manual, including 
those in the definition of a monitor call description, are octal. 
When indicated, bits in words are numbered in decimal with the 
leftmost bit of the word labeled BO and the rightmost bit of the word 
labeled B35. 
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1.5.2 Abbreviations 

The following abbreviations are used in this manual: 

BO, Bl, ... Bit 0, bit 1, ... of the computer word 

nBm Field whose rightmost bit is m and whose value is 

n (5B2, for example). 

LH Left Half (B0-B17 of the word) 

RH Right Half (B18-B35 of the word) 

JFN Job File Number 

PSB Process Storage Block (a table containing all 

monitor data for the process) 

JSB Job Storage Block (a table containing all monitor 

data relevant to the job) 

CCOC words Control Character Output Control words 

(2 words containing 36 2-bit bytes that determine 
the way in which control characters are output. 
Pefer to Section 2.4.9.2.) 

FDB File Descriptor Block (a table in a file that 

contains information about the file) . Pefer to 
Section 2.2.8. 



1.5.3 Symbols 

The symbols used in this manual, including the names of the monitor 
calls, are defined in the system file MONSYM. MAC. A program that uses 
a monitor call or other symbol must include the statement 

SEARCH MONSYM 

before the first occurrence of a symbol. Failure to include this 
statement causes errors in the compilation of the program. Refer to 
Appendix B for a listing of MONSYM. 



1.5.4 Unimplemented Features 

The MONSYM file contains symbol names for several monitor calls and 
bit positions that are not described in this manual. These features 
are not implemented in TOPS-20. 

If an unimplemented monitor call is used in a user program, it causes 
an illegal instruction interrupt unless followed by an ERJMP or ERCAL 
symbol. In this case, the ERJMP will be executed.. It is recommended 
that unimplemented or undefined bit positions be zero to allow for 
future expansion. 
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CHAPTER 2 
FUNCTIONAL ORGANIZATION OF JSYS * S 



2.1 ACCOUNTING FUNCTIONS 

The monitor calls in this group initiate and delete jobs from the 
system. They also change and read accounting information about these 
jobs . 

The monitor calls that perform accounting functions are as follows: 

LOGIN Logs a job into the system 

GACCT Reads a job's account 

SACTF Sets a file's account 

GACTF Reads a file's account 

USAGE Writes entries into the system's accounting data file 

VACCT Validates an account 



2.2 REFERENCING FILES 

All files in the system, including the system's 
normally referenced with the calls in this 
describes the privileged calls for referencing 
without using the TOPS-20 file system. 



file directory, are 
group. Section 2.11 
the disk directly, 



2.2.1 File Specifications 

A file in TOPS-20 is identified by its node name, device name, 
directory name, filename, file type, and generation number. These 
five items uniquely identify any file on the system that is accessible 
to a user. The device name identifies the device on which the file is 
stored. The directory name identifies the directory containing the 
file. The filename, type, and generation number identify a particular 
file in the directory. 

A file can also have attributes associated with it to further specify 
information about the file. See the description of the long-form 
GTJFN JSYS for a list of the possible file attributes. 

The general format of a file specification is: 

node: :d ev : <d irec t o ry>n ame. typ. gen, -attribute-l; attribute -2. . . 

Refer to the TOPS--20 User's Guide for the complete description of file 
specifications. 
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If a field of the file specification (or filespec) is omitted, it can 
be supplied by the program or from standard system values. (Refer to 
Section 2.2.3.) 

Whenever an ESC is encountered in the file specification string, the 
system looks for a file whose specification matches the fields input 
thus far. A match is indicated if the input string either exactly 
matches an entry in the appropriate table, or is an initial substring 
of exactly one entry. In the latter case, the portion of the matching 
entry not appearing in the input string is output to a specified 
output file. The field terminator is output also. 

Recognition is done on successive fields with the fields being 
defaulted if need be. If the file specification cannot be uniquely 
determined, the system recognizes as many entire fields as are unique, 
and outputs a bell to the terminal, signifying that more input is 
required from the user. If the input string cannot possibly match any 
existing file specification, the system returns an error. 

CTPL/F behaves like ESC except recognition stops after the current 
field. This allows the filename to be recognized, for example, but 
not the file type. 

If recognition is not used, then each field must be included as 
indicated in the general format above. The input must exactly match 
some existing file specification unless the program specifies in the 
GTJFN call that new specifications are allowed (output files) . 

Without ESC or CTRL/F, no recognition is done. The system substitutes 
the default values supplied by your program for fields completely 
omitted from the file specification. The file specification is 
complete whenever all fields have been recognized or a terminator has 
been input. File specification terminators are described in the GTJFN 
call description. 

The following editing characters are recognized during the input of 
file specifications: 

DELETE erases one character. If no more characters remain in 
the input, a bell is output. 

CTRL/W deletes back to the last punctuation character. If no 
more characters remain in the input, a bell is output. 

CTRL/U aborts the entire filename-gathering operation. 

CTRL/R retypes the entire input as specified so far and awaits 
further input. 



2.2.2 Logical Names 

Logical names are user-specified default values for one or more fields 
in a file specification. Through the use of logical names, the user 
can override standard file specification fields built into TOPS-20 
programs because logical name fields take precedence over default 
fields set by a program. However, the user can still specify any 
fields explicitly since a logical name defines values to be used only 
if none are given by the user. The user defines logical names with 
the DEFINE command or the CRLNM monitor call. Refer to the TOPS-20 
User's Guide for the complete description of logical names. 
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2.2.3 File Handles 

It is necessary to have file handles that can be contained in a few 
bits and do not require extensive lookup procedures for each refer- 
ence. The file specification is the fundamental handle on a file, but 
this specification fits neither criterion above. Therefore in 
TOPS-20, files are referenced by handles called JFNs (Job File 
Numbers) . The JFN is a small number and is valid within the context 
of the job (i.e., within any process of the job to which it is 
assigned). However, the handle is not valid between jobs. That is, 
JFN 2 in job 11 will generally be a handle on a completely different 
file than JFN 2 in job 18. 

A JFN is associated with a file with either the GTJFN or GNJFN monitor 
call. The GTJFN call accepts a file specification and returns a JFN 
for the indicated file. If a field of the specification is omitted, 
it may be supplied by the program defaults or from standard system 
values. If the file specification refers to a group of files (because 
of wildcard characters, see below), the GNJFN call can be used to 
associate the JFN to the next file in the group. 

A logical name can apply to one or more fields of the file 
specification passed to the GTJFN call. The logical name must be the 
first identifier passed to GTJFN and must be terminated with a colon. 

The GTJFN call uses a certain search order when obtaining a field in a 
file specification. This order is as follows: 

1. Use the field explicitly typed by the user or the one 
specified in the primary input string. 

2. Use the value for the field that is specified in the logical 
name specification. 

3. Use the value for the field that is specified in the default 
block by the program. This is only for the long form of the 
GTJFN call. 

4. Use the system default value if all of the above searches 
fail. 

In the special case of a device field specification, where the device 
name has been obtained from either the program default or the system 
default, the device field is checked to see if it is actually a 
logical name. If it is, then the values specified in its definition 
become defaults for all fields, including the device field. 

If the specific call to GTJFN permits, wildcard characters (either an 
asterisk or a percent sign) can appear in the device, directory, 
filename, type, or generation number fields. (The percent sign cannot 
appear in the generation number field.) An asterisk matches any 
occurrence of the field, including a null field. An asterisk as part 
of a field matches or more characters anywhere in the field. A 
percent sign matches any single existing character in the field. Upon 
completion of the operation, the JFN returned references the first 
file found when scanning in the following order: 

In order by structure name 

(PS: is first, arbitrary order for others) 
In alphabetic order by directory name 
In alphabetic order by filename 
In alphabetic order by file type 
In ascending numeric order by generation number 
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Note that for structures, only the construct DSK*: can be used. This 
means all available structures on the system. 

The GNJFN call can then be given to associate the JFN to the next file 
that matches the file specification. 

The fullword JFN (flags,, JFN) is termed an "indexable file handle" 
because it accepts a generic file specification (one including 
wildcard characters) and can be successively associated (by GNJFN) 
with each file matching the specification. Thus the JFN is "indexed" 
through a range of files. The number and type of files in the range 
are limited by the file specification, the privileges of the program, 
and the protection of individual files and directories within the file 
system. A program with WHEEL capabilities enabled can access any file 
in the TOPS-20 file system. 

The maximum number of JFN's allowed depends upon the space reserved 
for JFN-related information in the Job Storage Block (JSB) . Currently 
the maximum number of JFN's allowed is 140 (octal). 

The JFN's 100 (.PRIIN) and 101 (.PRIOU) are reserved for the primary 
input and output designators, respectively, and are never returned by 
the GTJFN (or GNJFN) call. The JFN 377777 (.NULIO) is reserved for 
the null designator. 

Ordinarily, the process of getting a file handle with GTJFN consists 
of the following: 

1. The user specifies the file name string. 

2. GTJFN checks the file name string for grammatical 
correctness. 

3. GTJFN checks the file for validity (For example, does the 
file actually exist?) 

4. If the file name passes these two checks, GTJFN returns a JFN 
or handle for the file. 

Thus a JFN is associated with an actual file in the TOPS-20 file 
system. 

It is sometimes desirable to skip the step of checking a JFN for 
validity. This is necessary any time that the association between the 
JFN and the physical file cannot be made, as happens when a JFN is 
requested for a file on magnetic tape. Also, it may be that the user 
himself wishes to prevent the JFN/file association from being made in 
order to check the file specification for grammatical correctness and 
then manipulate the file specification by adding or removing selected 
fields, or comparing it against another file specification. This type 
of JFN is termed a "parse-only" JFN. As it is not associated with any 
file, no file operations may be performed on it. 

Only the following JSYS ' s will accept a parse-only JFN: 

1. JFNS - converts a JFN to its file specification (in 
characters) 

2. WILD% - compares character strings and file specifications 
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2.2.4 File References 

All file operations are initiated by acquiring a JFN on a file using 
the GTJFN (or GNJFN) call. Some file operations, such as deleting, 
renaming, and status queries about the file, may be performed 
immediately after the JFN is acquired. Certain operations, 
particularly data transfers, require that the file be opened with an 
OPENF call on the JFN. 

When the user opens a file, he specifies the byte size to be used for 
byte I/O operations and the access requested to the file. Several 
implicit initialization operations, which affect subsequent references 
to the file, are also invoked when a file is opened. For example, a 
file's position pointer is normally reset to the beginning of the file 
such that the first sequential input operation reads the beginning 
data of the file. 

Access to files on regulated structures (those being tracked by the 
accounting system) cannot be given until the mount count for that 
structure is incremented with the .MSIMC function of the MSTP JSYS (or 
with the TOPS-20 MOUNT STRUCTURE command). All JFN's must be released 
before the mount count can be decremented with the .MSDMC function of 
the MSTR JSYS (or the TOPS-20 DISMOUNT STRUCTURE command) . 

All structures are regulated by default except the primary structure 
(PS:) . 



2.2.4.1 Files and Devices - Under TOPS-20, most devices may be 
treated as if they were files. For example, a GTJFN, OPENF, CLOSF, 
etc. may be performed directly on magnetic tape device MTA1 : without 
specifying a file name. This is because the device name itself is the 
file name. Disk devices, however, have multiple directories and 
multiple files, and the device name itself is not sufficient to 
uniquely identify a file. The general rule is that, for a complete 
TOPS-20 file specification, only those fields necessary to make the 
file unique for that device are required to get a JFN for the file. 
Thus, for most devices, the device name itself is sufficiently unique 
to get a JFN for the file. In this manual, when the phrase "opening a 
device" is used, it is in reference to the feature described above. 

For TOPS-20, disk devices are the only major exception to the rule 
that devices can be treated as files. Labeled tapes on MT: devices 
may be referenced either by device name alone (which gives access to 
all files on the tape) or by device name and file name (which gives 
access only to the specified file). 



2.2.5 Sample Program 

The following sample program acquires JFN's, opens both an input and 
an output file, and then copies data from the input file to the output 
file in 7-bit bytes until the end of the input file is encountered. 
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*** PROGRAM TO COPY INPUT FILE TO OUTPUT FILE. *** 
(USING BIN/BOUT AND IGNORING NULL'S) 



TITLE FILEIO 
SEARCH MONSYM 



; TITLE OF PROGRAM 

; SEARCH SYSTEM JSYS-SYMBOL LIBRARY 



;*** IMPURE DATA STORAGE AND DEFINITIONS *** 



INJFN: BLOCK 1 
OUTJFN: BLOCK 1 



PDLEN=3 
BLOCK PDLEN 



PDLST: 

Tl = = l 
T2 = = 2 
T3 = = 3 
T4 = = 4 
T5 = --=5 



P = = 17 

.*** PROGRAM INITIALIZATION *** 

START: RESET% 



; STORAGE FOP INPUT JFN 
; STORAGE FOR OUTPUT JFN 

; STACK HAS LENGTH 3 

;SET ASIDE STORAGE FOR STACK 

;JSYS AC'S 

; TEMPORARY AC'S 
;PUSH DOWN POINTER 

; CLOSE FILES AND INITIALIZE PROCESS 



MOVE P,[IOWD PDLEN, PDLST] ;ESTABLISH STACK 

;*** GET INPUT-FILE *** 

INFIL: HRROI Tl,[ASCIZ / 

INPUT FILE: /] ; PROMPT FOR INPUT FILE 

PSOUT% ;ON CONTROLLING TERMINAL 

MOVE Tl, [GJ%OLD+GJ%FNS+GJ%SHT] ; SEARCH MODES FOP. GTJFN 

; [EXISTING FILE ONLY , FILE-NP'S IN B 
; SHORT CALL ] 

MOVE T2, [ .PRIIN, , .PRIOU] ; GTJFN 'S I/O WITH CONTROLLING TERMINAL 



GTJFN% 
ERJMP [ PUSHJ P,WARN 
JRST INFIL] 
MOVEM Tl, INJFN 

;*** GET OUTPUT-FILE *** 

OUTFIL: HPPOI Tl,[ASCIZ / 
OUTPUT FILE: /] 

PSOUT% 

MOVE Tl , [GJ%FOU+GJ%MSG+G 



GET JOB FILE NUMBER (JFN) 
IF ERROR, GIVE WARNING 
AND LET HIM TRY AGAIN 
SUCCESS, SAVE THE JFN 



PROMPT FOR OUTPUT FILE 

PRINT IT 
J%CFM+GJ%FNS+GJ%SHT] ; GTJFN SEARCH MODES 

[DEFAULT TO NEW GENERATION , PRINT 
MESSAGE , REQUIRE CONFIRMATION 
FILE-NR'S IN B , SHORT CALL ] 



MOVE T2, [ .PRIIN, , .PRIOU] ; I/O WITH CONTROLLING TERMINAL 



GTJFN% 
ERJMP [ PUSHJ P,WARN 
JRST OUTFIL] 
MOVEM Tl, OUTJFN 



GET JOB-FILE NUMBER 
IF ERROR, GIVE WARNING 
AND LET HIM TRY AGAIN 
SAVE THE JFN 
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;NOW, OPEN THE FILES WE JUST GOT 

; INPUT 

MOVE Tl , INJFN 
MOVE T2, [7B5+OF%PD] 
OPENF% 
ERJMP FATAL 



OUTPUT 



MOVE Tl,OUTJFN 
MOVE T2, [7B5+OF%WR] 
OPENF% 
ERJMP FATAL 



; RETRIEVE THE INPUT JFN 

; DECLARE MODES FOR OPENF [7-BIT BYTES + INPUT] 

;OPEN THE FILE 

;IF ERROR, GIVE MESSAGE AND STOP 



GET THE OUTPUT JFN 

DECLARE MODES FOR OPENF [7-BIT BYTES + OUTPUT; 

OPEN THE FILE 

IF ERROR, GIVE MESSAGE AND STOP 



;*** MAIN LOOP : COPY BYTES 

LOOP: MOVE Tl, INJFN 

BIN% 

ERJMP DONE 
JUMPE T2,LOOP 
MOVE Tl,OUTJFN 
BOUT% 

ERJMP FATAL 
JRST LOOP 



FROM INPUT TO OUTPUT *** 
;GET THE INPUT JFN 



TAKE A BYTE FROM THE SOURCE 

IF ERROR, CHECK FOR END OF FILE. 

SUPRESS NULLS 

GET THE OUTPUT JFN 

OUTPUT THE BYTE TO DESTINATION 

IF ERROR, GIVE MESSAGE AND STOP 

LOOP, STOP ONLY ON A BYTE (FOUND 

AT LOOP+2) 



;*** TEST FOR END OF FILE, ON SUCCESS FINISH UP *** 



DONE: GTSTS% 

TLNN T2, (GS%EOF) 
PUSHJ P, FATAL 

CLOSIF: MOVE Tl , INJFN 
CLOSF% 
ERJMP FATAL 

CLOSOF: MOVE Tl,OUTJFN 

CLOSF% 
ERJMP FATAL 

HRROI Tl, [ASCIZ/ 
[DONE]/] 

PSOUT% 

JRST ZAP 



GET THE STATUS OF INPUT FILE. 
AT END OF FILE? 
NO, I/O ERROR 

;YES, RETRIEVE INPUT JFN 

;CLOSE INPUT FILE 

;IF ERROR, GIVE MESSAGE AND STOP 

; RETRIEVE OUTPUT JFN 

; CLOSE OUTPUT FILE 

;IF ERROR, GIVE MESSAGE AND STOP 

SUCCESSFULLY DONE 

PRINT IT 

STOP 
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;*** ERROR HANDLING *** 

FATAL: HRROI Tl,[ASCIZ/ 

?/] 

PUSHJ P, ERROR 
JRST ZAP 



FATAL ERRORS PRINT ? FIRST 
THEN PRINT ERROR MESSAGE, 
AND STOP 



WARN: 

%/] 



HRROI Tl, [ASCIZ/ 



;WARNINGS PPINT % FIRST 

; AND FALL THRU 'ERROR' BACK TO CALLER 



ERROR: PSOUT% 

MOVE Tl , [ .PPIOU] 
MOVE T2 , [ .FHSLF, ,-1 
SETZB T3,T4 
ERSTP% 

JFCL 

JFCL 
POP J P f 



ZAP 



HALTF% 
JRST START 
END START 



PRINT THE ? OR % 

DECLARE PRINCIPAL OUTPUT DEVICE FOR ERROR MESSAGE 

CURRENT FORK,, LAST ERPOR 

NO LIMIT, , FULL MESSAGE 

PRINT THE MESSAGE 

IGNORE UNDEFINED EPROR NUMBER 

IGNORE EPROR DURING EXECUTION OF ERSTR 

RETURN TO CALLER 

STOP 

WE ARE RESTARTABLE 

TELL LINKING LOADER START ADDRESS 



2.2.6 File Access 

TOPS-20 provides a general mechanism for protecting files against 
unauthorized access. This mechanism includes the ability to protect 
access to files on a directory-wide basis as well as on an 
individual-file basis. 

Generally, access to a file depends on the kind of access desired and 
the relationship of the user making the access to the directory 
containing the file. The possible relationships a user may have to 
the file's directory are: 

1. The directory containing the file is the user's connected or 
one of the user's accessed directories. Users satisfying 
this relationship have owner access to the files in the 
directory. 

2. The directory containing the file is in the same group as the 
user. Users satisfying this relationship have group member 
access to the files in the directory. 

3. The directory containing the file is outside the group 
membership. Users satisfying this relationship have world 
access to the files in the directory. 

Both users and directories may belong to groups. The group-member 
relationship is satisfied if both the directory and the user belong to 
one or more of the same groups. Groups are assigned by the system 
| manager or operator. (Refer to the TOPS-20 System Manager's Guide. ) 
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The type of access permitted to a file for each relationship is 
represented by the value of a 6-bit field. The possible values are: 



Value 

40 

20 

10 

4 

2 



Symbol 

FP%RD 

FP%WR 

FP%EX 

FP%APP 

FP%DIR 



Meaning 

Read access 

Write access 

Execute access 

Append access 

Directory listing access. If a 

user does not have at least this 

type of access, a GTJFN will find 

the file only if wildcards are not 

used. A GNJFN will not find the 

file. 



The following table illustrates some useful combinations of the values 
shown above: 



Value 

12 
42 



60 



Symbol 

FP%EX+FP%DIR 
FP%RD+FP%DIR 



FP%RD+FP%WR 



Meaning 

Execute-only access 

Usual protection allowing users to 

access a file without being able 

to modify it. 

Good for hiding files that 

specific programs can write to. 

Programs should be execute-only 

and the program should set the 

"restricted" access bit in the 

GTJFN so as not to reveal the 

filename . 



remaining 
-5 being the 
e remaining 
ng access is 



The access given to a group member includes the access given to all 
members outside the group. Also, the access given to the owner 
includes the access given to group members. Thus, the owner of a file 
or a user in the owner's group cannot have less access than users 
outside the group. 




2.2.7 Directory Access 

Access to a directory is protected in a manner similar to, bu 
distinct from, that of a file. An 1.8-bit code, containing three 6-bi 
fields, is associated with each directory. Each of the three field 
controls access by users in the same way that access to files i 
controlled. For directories, however, each 6-bit fiel^ ^^^ v^wo ^r, 
of the following values. 



_d can have 



s 
one 
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Value 
40 



Symbol 
DP%RD 



10 



DP%CN 



DP%CF 



Meaning 

Accessing files in the directory 
according to the access code on 
the individual files is allowed. 
A GTJFN call for a file in the 
directory will fail if the user 
does not have this access. 

Connecting to the directory 
without giving a password is 
allowed. With this access, a 
group member can change the FDB 
(as the owner) as well as times, 
dates, and accounting information 
for files in the directory. Other 
operations on the files are 
subject to the access codes of the 
files. If the user is connected 
to the directory, he has ownership 
access to the files; if he is not 
connected, he has group membership 
access. 

Creating files in the directory is 
al lowed . 



When a user requests access to a file, the monitor checks the 

directory access code first. If the directory code allows the desired 

access, the monitor then checks the access code of the individual 
file. 

The access actually granted to a file is specified when the user opens 
the file with the OPENF call. If the access specified in the OPENF 
call is the same as or less than the access permitted by the 18-bit 
access code, the user is granted access to the file. Thus, for a user 
to be granted access to a specific file, two conditions must be met: 

1. The access code (both directory and file) must permit the 
user to access the file in the desired manner (e.g., read, 
wr i te) . 

2. The file must not be open for a conflicting type of access. 



2.2.8 File Descriptor Block 

Each file has an associated File Descriptor Block (FDB) that contains 
various information about the file. The format of the FDB is shown in 
Table 2-1. 

The description of each word or bit in the FDB indicates whether the 
user can change it, and if so, what types of access are required. The 
types of access are: 



1. WRITE - write access 

2. OWNER - owner access 

3. W/OPP - WHEEL or OPERATOR capabilities enabled 
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In some cases, separate JSYS's are required to read, set, and/or clear 
various words or bits. These functions are indicated by: 



1. (R) - read 

2. (S) - set 

3. (C) - clear 

4. (SC) - set/clear 



Table 2-1 
File Descriptor Block (FDB) 



Word 


Symbol 


Meaning 





.FBHDP 


FDB header 
follows: 


word. Individual fields are as 






B0-B28 


Reserved for DEC 
UNCHANGEABLE 






B29-35 (FB% 


LEN) 

Length of this file's FDB 

UNCHANGEABLE 


1 


.FBCTL 


BO (FB%TMP) 


File is temporary. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y Y 






Bl (FB%PRM) 


File is permanent. The 
contents of the file may be 
deleted, but the FDB may not. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y Y 






B2 (FB%NEX) 


File does not yet have a file 
type; file does not really 
exist. 

UNCHANGEABLE 






B3 (FB%DEL) 


File is deleted. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y* Y 

*This bit may be changed by the 
owner providing that bit FB%ARC 
(in .FBCTL) is not set. 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 



Symbol 



Meaning 



.FBCTL 
(Cont. ) 



B4(FB%NXF) File does not exist because it 
has not yet been closed. 

UNCHANGEABLE 
B5(FB%LNG) File is longer than 512 pages. 

UNCHANGEABLE 
B6(FB%SHT) Reserved for DEC. 

UNCHANGEABLE 
B7(FB%DIR) File is a directory. 

UNCHANGEABLE 

B8(FB%NOD) File is not to be saved by the 
backup system. 



JSYS 
CHFDB 



WRITE OWNER W/OPR 
Y Y Y 



B9 (FB%BAT) 



File may have one or more bad 
pages. This bit indicates that 
I/O errors have occurred for a 
page (or pages) of a file and 
the contents of these pages are 
suspect. 

This bit is set whenever the 
system has a disk I/O error on 

a page of an open file. The 

faulty disk address is also 

added to the list in the 

system's BAT blocks for that 
disk structure. 

Tf an EXPUNGE is performed for 
a file for which bit FB%BAT is 
set, the system performs an 
additional function as it 
releases the pages of the file 
back to the available resource 
pool: it checks each disk 
address in the file against the 
list of bad regions in the 
structure's BAT blocks and if 
it finds a match, it leaves 
that page marked as "in use" in 
the bit map of available disk 
pages, so that the faulty page 
is not reused. 

UNCHANGEABLE 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 


Symbol 


Meaning 


] 


.FBCTL 
(Cont. ) 


B10(FB%SDR) Directory has subdirectories. 

UNCHANGEABLE 

B11(FB%APC) File has archive status. 
Appropriate words in the FDB 
(below) specify where the file 
is archived. 

JSYS WRITE OWNER W/OPR 

ARCF N N Y 

B12(FB%INV) File is invisible. Invisible 
files can be seen only by using 
the G1%IIN option to GTJFN. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y Y 

B13(FB%OFF) File is offline. This is set 
by DELF when it removes the 
contents from disk and cleared 
when APCF restores the contents 
to disk. 

JSYS WRITE OWNER W/OPR 

DELF(S) N N Y 
ARCF(C) N N Y 

B14-B17 (FB%FCF) 

File class field. If value of 
field is O(.FBNRM), file is not 
an RMS file. If value of field 
is l(.FBRMS), file is an RMS 
file. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y Y 

B18 (FB%NDL) 

Do not delete this file. Do 
not delete even if overwritten 
by a write or a rename. 

JSYS WRITE OWNER W/OPR 

CHFDB N N Y 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 


Symbol 


Meaning 


2 


. FBEXL 


Link to FDB of next file with the same name 
but different file type. 

UNCHANGEABLE 


3 


. FBADR 


Disk address of file index block. 
UNCHANGEABLE 


4 


.FBPFT 


File access code. 
LH: 500000 

UNCHANGEABLE 

FH: file access bits. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y N 


5 


.FBCFE 


Date and time that the file was closed 
after the last write to the file. Modified 
when any program writes to the file. 

JSYS WRITE OWNER W/OPP 

CHFDB N N Y 


6 


.FBAUT 


Pointer to string containing the name of 
the author. This word is not under direct 
user control. Tt is only changed 
indirectly, when the file author string is 
changed . 

JSYS WRITE OWNER W/OPP 

GFUST(R) Y Y Y 
SFUST(SC) N Y N 


7 


. FBGEN 


Generation and directory numbers of file. 
LH(FB%GEN): generation number of the file. 

UNCHANGEABLE 

PH(FB%DRN): monitor internal directory 
number of the file (only if B7 
of . FBCTL is on) . 

UNCHANGEABLE 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 



Symbol 



Meaning 



10 



.FBACT 



11 



.FBBYV 



Account information. This word contains a 
byte pointer to an alphanumeric account 
designator; it can be changed with the 
SACTF monitor call. 

JSYS WRITE OWNER W/OPP 

SACTF Y Y Y 

File I/O information. 

B0-B5 (FB%RET) 

Number of generations to retain 
(retention count). If two 
generations of the same file 
have different retention 
counts, the count is taken from 
the generation currently being 
used . 



JSYS 
CHFDB 



WRITE OWNEF W/OPR 
Y Y Y 



B6-B11(FB%BSZ) 

File byte size. This field can 
be changed by user with write 
access . 



JSYS 
CHFDB 



WRITE OWNER W/OPR 
Y Y Y 



B14-B17 (FB%MOD) 

Data mode of last open of file. 
This field can be changed by 
user with write access. 



JSYS 
CHFDB 



WRITE OWNER W/OPR 
Y Y Y 



B18-B35(FB%PGC) 

Page count of file. Note that 
the monitor keeps the page 
count updated, so under normal 
circumstances a user need not 
and should not alter this 
count . 



JSYS 
CHFDB 



WRITE OWNER W/OPR 
N N Y 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 


Symbol 


Meaning 


12 


.FBSIZ 


Number of bytes in the file. (Refer 
Section 2.2.11.) 

JSYS WRITE OWNER W/OPR 

CHFDB Y Y Y 


to 


13 


. FBCRV 


Date and time of creation of file. 
JSYS WRITE OWNEF W/OPR 
CHFDB Y Y Y 




14 


. FBWRT 


Date and time that the file was opened vv 
the last write to the file was made. 

JSYS WRITE OWNER W/OPR 

CHFDB Y Y Y 


hen 


15 


.FBPEF 


Date and time of last nonwrite access 
file. 

JSYS WPITE OWNER W/OPR 

CHFDB Y Y Y 


to 


16 


•FBCNT 


Count word. 

LH: number of writes to file. 

JSYS WRITE OWNER W/OPR 

CHFDB N N Y 

RH: number of references to file. 

JSYS WRITE OWNER W/OPR 

CHFDB N N Y 




17 


.FBBKO 


Used by DUMPER for backup purposes. 
JSYS WPITE OWNER W/OPR 
CHFDB N N Y 




20 


.FBBK1 


Reserved for DEC. 
UNCHANGEABLE 




21 


.FBBK2 


Reserved for DEC 








UNCHANGEABLE 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 


Symbol 


Meaning 


22 


.FBBBT 


The right, h 
in the fil 
from disk. 


alf contains the number of pages 
e when the contents were deleted 






UNCHANGEABLE 






The left h 
flags : 


alf is used for the following 






Bl (AR%RAR) 


User request for a file to be 
archived . 

JSYS WRITE OWNER W/OPR 

APCF Y Y Y 






B2 (AR%RIV) 


System request for an involuntary 
migration of a file. 

JSYS WRITE OWNER W/OPR 

ARCF N N Y 






B3 (AP%NDL) 


Do not delete the contents of the 
file from disk when the archival 
is complete. 

JSYS WRITE OWNER W/OPR 

ARCF N Y Y 






B4 (AR%NAR) 


Resist involuntary migration. 
This bit is a note from the user 
to the system access control 
program asking that the file not 
be moved offline if possible. 

JSYS WRITE OWNER W/OPR 

APCF N Y Y 






B5 (AR%FXM) 


File is exempt from involuntary 
migration . 

JSYS WRITE OWNER W/OPR 

ARCF N N Y 






B6 (AR%1ST) 


First pass of an 
archival-collection run is in 
progress. 

JSYS WRITE OWNER W/OPR 








CHFDB N N Y 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 



Symbol 



Meaning 



22 



.FBBBT 
(Cont. ) 



23 



24 



25 



26 



FBNET 



FBUSW 



FBGNL 



FBNAM 



B7(AR%RFL) Restore failed. Set by ARCF to 
to indicate that the restore it 
is waiting for has failed. 



JSYS 
ARCF 



WRITE OWNER W/OPR 
N N Y 



B10(AR%WRN) Generate a message warning that 
the file's off-line expiration 
date is approaching. 

7B17 (AR%RSN) 

Reason file was moved offline: 
.AREXP(l) file expired 
.AFFAR(2) archiving was 

requested 
.ARRIR(3) migration was 

requested 

JSYS WRITE OWNER W/OPR 
ARCF(W) N N Y 
GTFDB(R) Y Y Y 

B18-B35(AF%PSZ) 

The right half of .FBBBT is used 
to store the number of pages in a 
file when the contents were 
removed from disk. 

JSYS WRITE OWNER W/OPR 
ARCF(W) N N Y 
GTFDB(R) Y Y Y 

On-line expiration date and time. Specifies 
the date and time at which a file is 
considered expired, or specifies an interval 
(in days) after which the file is considered 
expired . 

JSYS WRITE OWNEF W/OPR 

SFTAD N Y Y 

User-settable word. 

JSYS WRITE OWNER W/OPR 

CHFDB N Y Y 

Address of FDB for next generation of file. 

UNCHANGEABLE 

Pointer to filename block. 

UNCHANGEABLE 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 



Symbol 



Weaning 



27 
30 



.FBEXT 
. FBLWR 



31 



FBTDT 



32 



FBFET 



33 



FBTPl 



34 



.FBSS1 



Pointer to file type block. UNCHANGEABLE 

Pointer to string containing the name of 
the user who last wrote to the file. This 
name is read with the GFUST monitor call 
and can be changed with the SFUST monitor 
call. 

Note that word . FBLWR may only be changed 



indirectly 
string) . 
directly. 

J SYS 

GFUST(R) 
SFUST(CS) 



(by specifying 
This word cannot 



a new name 
be changed 



WRITE OWNER W/OPR 



Archive or collection tape-write date and 
time. This is the date and time (in 
internal format) that file was last written 
to tape (for either archiving or 
migration) . 



JSYS 



ARCF 



WRITE OWNER W/OPR 



N 



N 



Offline expiration date and time. 
Specifies the date and time (or interval) 
after which a file in the archives or on 
virtual disk is considered expired. Used 
for tape recycling. Modified by SFTAD. 



JSYS 
SFTAD 



WRITE OWNER W/OPR 
Y Y Y 



Contains the tape ID for the first archive 
or collection run. 



JSYS 
ARCF 



WRITE OWNER W/OPR 
N N Y 



Contains the saveset and tape file numbers 
for the first tape. The left half is the 
number of the saveset in which the file is 
recorded, and the right half is the tape 
file number within that saveset. 



JSYS 
ARCF 



WRITE OWNER W/OPR 
N N Y 
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Table 2-1 (Cont.) 
File Descriptor Block (FDB) 



Word 


Symbol 


Meaning 


35 


.FBTP2 


Tape ID for second archive or collection 
run. Otherwise similar to .FBTP1. 

JSYS WRITE OWNEP W/OPR 

ARCF N N Y 


36 


.FBSS2 


Saveset and tape file numbers for the 
second archive or collection run. 
Otherwise similar to .FBSS1. 

JSYS WRITE OWNER W/OPR 

ARCF N N Y 



The maximum length FDB block that TOPS-20 will create (37 octal) may- 
be specified with the symbol .FBLEN. 



2.2.9 Primary Input and Output Files 

Each process in a job has a primary input file and a primary output 
file. Both files are normally the controlling terminal, but can be 
changed to other files (with the SPJFN call). 

The primary input and output files are referenced with designators 
.PRIIN (JFN 100) and .PRIOU (JFN 101), respectively. Programs should 
be coded to do their "terminal" I/O to these designators, so that they 
can be used with command files without modification. Only in extreme 
cases should a program reference its controlling terminal (.CTTRM) 
di rectly . 



2.2.10 Methods of Data Transfer 

The most simple form of I/O is sequential byte I/O, as shown in the 
sample program. (Refer to Section 2.2.5.) This form of data transfer 
may be used with any file. A pointer maintained in the monitor is 
implicitly initialized when a file is opened and advanced as data is 
transferred. For files on disk, there are two other methods of data 
transfers. First, random access byte t/o is possible by using the 
SFPTR call or the PIN/ROUT calls. Second, entire pages of data may be 
mapped with the PMAP call. 



2.2.11 File Byte Count 

For disk files, TOPS-20 maintains a file byte count (.FBSIZ) in the 
FDB. This count is set by the monitor when sequential output (e.g., 
BOUT, SOUT) occurs to the file and thus, on sequential output, 
reflects the number of bytes written in the file. 
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When output occurs to the file using the PMAP call, the monitor does 
not set the file byte count. In this case, the number of bytes in the 
file may be different from the file byte count stored in the FDB . To 
allow sequential I/O to occur later to the file, the program should 
update the file byte count (.FBSIZ) and the file byte size (FB%BSZ) in 
the FDB before closing the file. This is done with the CHFDB monitor 
call. 

When output occurs to the file using random output calls (FOUT, for 
example), the file byte count is a number one greater than the highest 
byte number in the file. 

The file byte count is interpreted according to the byte size stored 
in the FDB, not the byte size specified when the file is opened. When 
a new file is opened, the byte size stored in the FDB is 36 bits, 
regardless of the byte size specified in the OPENF call. If the 
program executes a CHFDB call to change the file byte count, it must 
usually change the byte size (FB%BSZ) so that both values reflect the 
same size bytes. 



2.2.] 2 EOF Limit 

There is an EOF limit associated with every opening of a file. This 
limit is the number of bytes that can be read with a sequential input 
call (e.g., BIN, SIN). When the program attempts to read beyond this 
limit using sequential input, the call returns a byte and an 
end-of-file condition. This condition may generate a software 
interrupt (refer to Section 2.6) if the user has not included an EFJMP 
or ERCAL as the next instruction following the call. (Refer to 
Chapter 1.) 

The EOF limit is computed when the file is opened with the OPENF call. 
The monitor computes this limit by determining the total number of 
words in the file and dividing this number by the byte size given in 
the OPENF call. The total number of words in the file is determined 
from the file byte count (.FBSIZ) and the file byte size (FB%BSZ) 
stored in the FDB. 

Note that page-mode I/O JSYS's, such as PMAP, ignore the EOF limit and 
can read any existing page of the file. However, page-mode JSYS's can 
only read pages within an existing file section (the address space of 
a file delimited by 1 index block - 512 pages). 



2.2.13 Input/Output Errors 

While performing I/O or I/O-related operations, it is possible to 
encounter one or more error conditions. Some of these are user-caused 
errors (e.g., illegal access attempts), and others are I/O device or 
medium errors. TOPS-20 indicates such error conditions by setting 
error bits in the JFN status word (refer to the GTSTS call) and by 
initiating a software interrupt request (refer to Section 2.6) if the 
user has not included an FRJMP or ERCAL after the call. If the 
process in which an I/O error occurs is not prepared to process the 
interrupt, the interrupt is changed into a process terminating 
condition with the expectation that the process 1 immediate superior 
will handle the error condition. The TOPS-20 Command Language is 
prepared to detect and diagnose I/O errors; thus, a process running 
directly beneath the process containing the Command Language need not 
do its own I/O error handling unless it chooses to do something 
special . 
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I/O errors can occur while a process is executing ordinary machine 
instructions as well as JSYS's. For example, if a PMAP operation is 
performed that maps a page of a file into a page of a process, the 
file I/O transfer does not usually occur until a reference is made by 
the process to that particular page of the file. If there is an I/O 
error in the transfer, it is detected at the time of this reference. 

An attempt to do I/O to a terminal that is assigned to another job (as 
a controlling terminal or with the ASND call) normally results in an 
error, but is legal if the process has the WHEEL capability enabled. 



2.2.13.1 Testing for End-of-File - The GTSTS JSYS, used in 
conjunction with ERCAL (or ERJMP) , is used to test for end-of-file. 
The following code fragment illustrates this: 



MOVE 
BIN% 
ERCAL EOFTST 



Tl ,INJFN 



;Get input JFN 
;Read a byte 



; Process byte 



EOFTST: 


MOVE 
GTSTS% 


Tl ,INJFN 




TLNN 


T2, (GS%EOF) 




PUSH J 


P, FATAL 




MOVE 


Tl , INJFN 




CLOSF% 






ERCAL 


FATAL 




POPJ 


P, 



;Get input JFN 
;Get status of that JFN 
;Did end of file occur? 
; No, I/O error occurred 
; Yes, close file 

;If can't close, issue message 
;0K to return 



FATAL 



;Here to issue error messages 
; on fatal file errors 



HALTF% 



;Halt on fatal error 



In the example above, the ERCAL after the BIN is executed only if a 

file error condition arises. The code that is entered as a result of 

the ERCAL can then do a GTSTS for the appropriate file and test for 
end-of-f lie. 



An alternate method to test for end-of-file is to use the 
and determine if the last error for the process is 10X4 
reached) . 



GETER JSYS 
(end of file 



The monitor calls used in referencing files are 



GTJFN Assigns a JFN to a file 

GNJFN Assigns a JFN to the next file 

JFNS Translates a JFN to a string 

WILD% Compares a wild file specification against 
file specification. Also compares strings. 

SPJFN Sets primary JFN's 

GPJFN Returns primary JFN's 

SWJFN Transposes two JFN's 

RLJFN Releases a JFN 



non-wild 



OPENF Opens a file 

CLOSF Closes a file 

CLZFF Closes a process' files 
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BIN Reads the next byte 

BOUT Writes the next byte 

FLIN Reads a floating-point number 

FLOUT Writes a floating-point number 

NIN Reads a number 

NOUT Writes a number 

PSOUT Writes string to primary output designator 

PBIN Reads byte from primary input designator 

PBOUT Output byte to primary output designator 

SIN Reads a string 

SOUT Writes a string 

SINR Reads a record 

SOUTR Writes a record 

RIN Reads a byte nonsequentially 

ROUT Writes a byte nonsequentially 

DUMPI Reads data in unbuffered data mode 

DUMPO Writes data in unbuffered data mode 

PMAP Maps pages 

RSCAN Reads and outputs rescan buffer 

RDTTY Reads data from primary input designator 

TEXTI Reads data from terminal or file 

CRLNM Creates a logical name 

INLNM Writes logical names 

LNMST Translates logical name to string 

CHFDB Changes a File Descriptor Block 

GTFDB Reads a File Descriptor Block 

SFUST Changes the author or last writer name string 

GFUST Reads the author or last writer name strinq 

CHKAC Checks access to a file 

ACCES Specifies access to a directory 

DIRST Translates directory or user number to a string 

RCDIR Translates directory name to number 

RCUSR Translates user name to number 

SIZEF Obtains file's length 

SFBSZ Sets file's byte size 

RFBSZ Reads file's byte size 

SFPTR Sets file's pointer 

RFPTR Reads file's pointer 

BKJFN Backspaces file's pointer 

RNAMF Renames a file 

SFTAD Sets file's time and dates 

RFTAD Reads file's time and dates 

STSTS Sets file's status 

GTSTS Reads file's status 

UFPGS Updates file's pages 

DELF Deletes a file 

DELDF Expunges deleted files 

DELNF Retains specified number of generations of file 

FFFFP Finds first free file page 

FFUFD Finds first used file page 
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2.3 OBTAINING INFORMATION 

The monitor calls in this group are used to obtain information from 
the system, such as the time of day, resources used by the current 
job, error conditions, and the contents of system tables. 

Several of these calls return time values (intervals and accumulated 
times, for example). Unless otherwise specified, these values are 
inteqer numbers in units of milliseconds. 



2.3.1 Error Mnemonics and Message Strings 

Each failure for a JSYS is associated with an error number identifying 
the particular failure. These error numbers are indicated in the 
manual by mnemonics (DEVXl, for example), and are listed with the 
appropriate calls. 

Some calls return the error number in the right half of an 
accumulator, usually in AC1; however, all calls leave the number in 
the Process Storage Block for the process in which the error occurred. 
Thus, a process can obtain the number for the last error that occurred 
(by means of the GETEP call) . 

In addition to the mnemonic of six characters or less, each error 
number has a text message associated with it that, describes the error 
in. more detail. The ERSTR call can be used to return the message 
string associated with any given error number. This call should be 
used for handling error returns. 

Refer to Chapter 3 and Appendix B for the listing of the error 
numbers, mnemonics, and messages. 



2.3.2 System Tables 

The contents of several system tables are available to programs for 
such purposes as generating status reports and collecting system 
performance statistics. Each table is identified by a fixed name of 
up to six characters, and consists of a variable number of entries. 
The -1 entry in each table is the negative of the number of data 
entries in the table; the data entries are identified by an index 
that increments from 0. 

Two calls exist for accessing tables. The first, SYSGT, accepts a 
table name and returns the table length, its first data entry, and a 
number identifying the table. The second, GETAB, accepts the table 
number returned by SYSGT, or obtained from the MONSYM file, and 
returns additional entries from the table. 

The system tables are as follows. Numeric table indexes are given in 
octal. Parallel tables, those for which a given index produces 
related information, are indicated by " (Pn) " where n is a unique 
number for that set of parallel tables. 
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Table 2-2 
System Tables 



Name 


Index 


Contents 


APRID 




Processor serial number 


BLDTD 




Date and time system was generated 


DBUGSW 




Debugging information 





1 


state of operator coverage 

= unattended 

1 = attended 

2 = debugging 

state of BUGCHK handling 

0=proceed 

l=breakpoint 


DEVCHR 


(PI) 


Device characteristics word, as 
described under the DVCHP JSYS in 
Chapter 3, except that B5 (DV%AV) is 
not meaningful . 


DEVNAM 


(PI) 


SIXBIT device name including unit 
number, e.g., MTA3 


DEVUNT 


(PI) 


LH: Job number to which device is 
assigned (with ASND) , or -1 if 
device is not assigned, or -2 if 
reserved for device allocator. 

RH: unit number, or -1 if device has no 
units (e.g. , DSK: ) 


DRMEFF 




Information on drum errors 






1 to n 


number of recoverable errors 

varies depending on type of drum 

being used 


DSKERF 




Information on disk errors 






1 to n 


number of recoverable disk errors 
varies depending on type of disk 
being used 


DWNTIM 




Downtime information 





1 


date and time when system will be 
shut down next 

date and time when system will 
subsequently be up 


HQLAV 




High queue load averages 
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Table 2-2 (Cont.) 
System Tables 



Name 


Index 


Contents 


IMPLT1 


c(P2) 




ARPANET - 1 fullword for each link: 






LH: 


internal connection number, index 
for: 

NETAWD 
NETBAL 
NETBTC 
NETBUF 
NETFSK 
NETLSK 
NETSTS 

or -1 if control link 






RH: 


B18-19 00 receive 

10 send 

11 free 
01 delete 

B20-27 host number 
B28-35 link number 

c (index) is derived from 
bits 24-35 of NETAWD. 


IMPLT2 


c(P2) 




ARPANET - 1 fullword for each link: 






LH: 
RH: 


BO-9 flags 

B10-17 byte size of buffer 

address of input buffer 

c (index) is derived from bits 24-35 
of NETAWD. 


IMPLT3 


c(P2) 




APPANET - 1 fullword for each link: 






LH: 
RH: 


address of output buffer 
message saved for retransmission 

c (index) is derived from bits 24-35 
of NETAWD. 


IMPLT4 


c(P2) 




ARPANET - 1 full word for each link 






LH: 
RH: 


address of current buffer 
message allocation in bits 

c (index) is derived from bits 24-35 
of NETAWD. 


JBONT 


Job # 




Owning job for CRJOB-created jobs. 
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Table 2-2 (Cont.) 
System Tables 



Name 


Index 


Contents 


JOBNAM 


Job # 


LH: reserved for DEC 

RH: index into the system program tables 
for the system program being used by 
this job (determined by the last 
SETSN call executed by the job) 


JOBPNM 


Job # 


SIXBIT name of program running in 
this job 


JOBRT 


Job # 


CPU time used, by the job (negative 
if no such job) 


JOBTTY 


Job # 


LH: controlling terminal line number, or 

-1 if none (i.e., job is detached) 
RH: reserved for DEC 


LOGDES 




Logging information 







designator for logging information 




1 


designator for job and error 
information 


LQLAV 




Low cfueue load averages 


NETHST 


c(P2) 


ARPANET - 1 full word for each 
internal connection: 

-1 if no foreign host, otherwise the 
same as IMPLT5. 

c (index) is derived from bits 24-35 
of NETAWD. 


NETAWD 


c(P2) 


ARPANET - 1 full word for each 
internal connection: 

BO-8 link number 

B9-17 unused 

B18-23 timeout countdown 

B24-35 index to link tables 

c (index) is internal connection 

(see IMPLTl) . 


NETBAL 


c(P2) 


ARPANET - number of bits allocated 
to each internal connection 

c (index) is internal connection 
(see IMPLTl) . 
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Table 2-2 (Cont.) 
System Tables 



Name 


Index 


Contents 


NETBTC 


c(P2) 


ARPANET - byte count statistics: 
the number of bits sent or received 
over each internal connection since 
the socket was created. 

c (index) is internal connection 
(see IMPLT1) . 


NETBUF 


c(P2) 


ARPANET - 1 fullword for each 
internal connection: 

LH: bytes per buffer 
RH : buffer location -1 

c (index) is internal connection 
(see IMPLT1) .. 


NETFSK 


c(P2) 


ARPANET - foreign socket number (32 
bits) for each internal connection 

c (index) is internal connection 
(see IMPLT] ) . 


NETLSK 


c(P2) 


ARPANET - local socket number for 
each internal connection 

c (index) is internal connection 
(see IMPLT1) . 


NETRDY 




ARPANET operational status table 







IMP down 

.GT.O IMP going down 

-1 IMP up 




1 


= network off, non-zero = network 
on 




2 


flags for NETSER (not for user) 




3 


time of last NCP cycle up 




4 


last IMP GOING DOWN message 
BO-15 reserved 
B16-17 panic 

1 scheduled hardware PM 

2 software reload 

3 emergency restart 
B18-21 number of 5-minute 

intervals before IMP goes 
down 
B22-31 number of 5-minute intervals 
IMP wil] be down 




5 


time of last IMP ready drop 




6 


time of last IMP ready up 




7 


time of IMP GOING DOWN message 
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Table 2-2 (Cont.) 
System Tables 



Name 


Index 


Contents 


NCPGS 




One-word table containing number of 
pages of real (physical) user core 
available in system. Note that this 
value includes resident variables, 
and thus not all of the pages can be 
assigned to a user process. 


NSWPGS 




Default swapping pages 


PTYPAR 




Pseudo-TTY parameter information 







LH: number of PTYs in system 
RH: TTY number of first PTY 


QTIMES 


to n 


Accumulated runtime of jobs on the n 
scheduler queues 


SNAMES 


(P3) 


SIXBIT name of system program, or 
if this entry is unused in this and 
the corresponding four tables. 


SNBLKS 


(P3) 


Number of samples in working set 
size integral 


SPFLTS 


(P3) 


Total number of page faults of 
system program 


SSIZE 


(P3) 


Time integral, of working set size 


STIMES 


(P3) 


Total runtime of system program 


SYMTAB 




SIXBIT table names of all GETAB 
tables 


SYSTAT 




Monitor statistics. The entries in 
this table are as follows: 







time with no runnable jobs 




1 


waiting time with 1 or more runnable 
jobs (waiting for page swapping) 




2 


time spent in scheduler 




3 


time spent processing pager traps 




4 


number of drum reads 




5 


number of drum writes 




6 


number of disk reads 




7 


number of disk writes 




10 


number of terminal wakeups 




11 


number of terminal interrupts 




12 


time integral of number of processes 
in the balance set 




13 


time integral of number of runnable 
processes 




14 


exponential 1-minute average of 
number of runnable processes 
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Table 2-2 (Cont.) 
System Tables 



Name 


Index 


Contents 




15 


exponential 5-minute average of 
number of runnable processes 




16 


exponential 15-minute average of 
number of runnable processes 




17 


time integral of number of processes 
waiting for the disk 




20 


time integral of number of processes 
waiting for the drum 




21 


number of terminal input characters 




22 


number of terminal output characters 




23 


number of system core management 
cycles 




24 


time spent doing postpurging 




25 


number of forced balance set process 
removals 




26 


time integral of number of processes 
in swap wait 




27 


scheduler overhead time (same as 
entry 2) in high precision units 




30 


idle time (same as entry 0) in high 
precision units 




31 


lost time (same as entry 1) in high 
precision units 




32 


user time 




33 


time integral of number of processes 
on high queue. (High queue is high 
priority, low numerical value.) 




34 


time integral of number of processes 
on low queue. (Low queue is low 
priority, high numerical value.) 




35 


sum of process disk-write waits 




36 


number of forced adjustments to 
balance set 




37 


integral of number of reserve pages 
of all processes in memory 




40 


integral of number of pages on 
replaceable queue. The replaceable 
queue contains pointers to all free 
memory pages. 




41 


high precision pager trap time 




42 


number of context switches 




43 


time spent on background tasks. 
These tasks include low-level data 
transfer between FSX20F and TOPS-20, 
and moving data from - swapping space 
to file space. 




44 


total system page traps 




45 


total saves from replacement queue. 
A "save" occurs when a desired page 
is found on the replacement queue 
and need not be paged in. 




46 


number of pages removed from memory 
during system-wide garbage 
collection. 




47 


inteqral of number of working sets 
in memory 
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Table 2-2 (Cont.) 
System Tables 



Name 



Index 



Contents 



50 

51 
52 

53 



SYSVER 



TICKPS 



TTYJOB 



line # 



LH 



PH 



integral of number of wait time 

without swap waits 

count of working set loads 

count of runable processes removed 

from balance set 

number of pages removed from memory 

during process-wide garbage 

collection. 



NOTE 

This table is subject to 
change (usually additions) 
as measuring routines are 
added to the system. 



An ASCIZ string identifying the 
system name, version, and date. The 
string has the following format: 

string, TOPS- 2 Monitor n.m(o)-p 

where "string" is the text 
contained in the file 
structure:<SYSTEM>MONNAM.TXT, "n" is 



the 


ma j or 


version number 


(1 to 


3 


digits) , " 


m" 


is 


the minor 


version 


number (0 


to 


2 


digits) , " 


o" is 


the 


edit 


number 


(1 


to 


6 digits) , 


and 


"p" 



is the number of the group that last 
edited the version (0 or 1 digit). 

If "m" is zero, it and its preceding 
period are omitted. If "p" is zero, 
it and its preceding hyphen is 
omitted. Otherwise, the period and 
the hyphen are stored along with the 
other information, including the 
spaces and parentheses as shown, in 
the table. 



One-word table containing 
clock ticks per second. 



number of 



positive job number for which this is 

the controlling terminal, or 

-1 for unassigned line, or 

-2 for line currently being assigned, 

or job number to which this line is 

assigned . 

-1 if no process is waiting for input 
from this terminal; other than -1 if 
some process is waiting for input. 
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The system program being run by a specific job may be determined from 
SNAMES, using an index obtained from table JOBNAM. 

The following monitor calls are used for obtaining information: 

GETER Returns the last error condition 

ERSTR Translates an error number to a string 

ESOUT Returns an error string 

SYSGT Returns values for a system table 

GETAB Returns a word from a system table 

GETNM Returns the program name being used by the job 

GETJI Returns job information for specified job 

GJINF Returns job information for current job 

GTAD Returns the system's date 

TIME Returns the time since the system was restarted 

RUNTM Returns the runtime of a job or process 

HPTIM Returns the high-precision clock values 

GTDAL Returns the disk allocation of a directory 

GTRPT Returns the paging trap information 

GTRPW Returns the trap words 



2.4 COMMUNICATING WITH DEVICES 

The monitor calls in this group are used to communicate with the 
devices on the system. Some of these devices are line printers, 
magnetic tapes, terminals, and card readers. 

Many of the monitor calls in this group take a device designator as an 
argument. This designator can be either 

LH: .DVDES (600000) +device type number 

RH: unit number for devices that have units, arbitrary code 

for structures, or -1 for non-structure devices that do not 

have units 

or 

LH: 

RH: .TTDES(400000)+terminal number, or . CTTRM (0 , ,-1) for 
controlling terminal 

The STDEV monitor call is used to convert a string to its 
corresponding device designator. 

The various devices are as follows: 
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Table 2-3 
Device Types 



Nanu 


s Description 


Type 


Symbol 


Units 


DSK 


disk structure 





.DVDSK 


no 


MTA 


: magnetic tape 


2 


. DVMTA 


yes 


MT: 


logical magnetic tape 


2 


.DVMTA 


yes 


LPT 


: spooled line printer 


7 


- 


yes 


plp 1 : 


[": physical line printer 


7 


.DVLPT 


yes 


CDR 


: spooled card reader 


10 


- 


yes 


PCDI 


?: physical card reader 


10 


.DVCDR 


yes 


FE: 


front-end 










pseudo-device 


11 


.DVFE 


no 


TTY 


terninal 


12 


. DVTTY 


yes 


PTY 


pseudo- terminal 


13 


.DVPTY 


yes 


NUL 


null device 


15 


.DVNUL 


no 


NET 


ARPA network 


16 


.DVNET 


no 


CDP 


spooled card punch 


21 


- 


yes 


PCDI 


D : physical card punch 


21 


.DVCDP 


yes 


DCN 


DECnet active 










component 


22 


. DVDCN 


no 


SRV 


: DECnet passive 










component 


23 


.DVSRV 


no 



Device-designators may be formed for the devices shown above by taking 
the given symbolic device-type and adding .DVDES (600000) . 

The null device is an infinite sink for unwanted output and returns an 
EOF on input. 

Device-dependent status bits are defined for some devices. These bits 
can be set or returned with the SDSTS or GDSTS call, respectively. 

When an assignable device is assigned (by the ASND call) or opened (by 
the OPENF call) by one job, other jobs cannot do the following: 

1. Assign the device with ASND. 

2. Execute an OPENF call for the device, even if the JFN 
properly represents the device. 

Structures are not restricted to these limitations; more than one 
user can simultaneously execute the OPENF call for files on 
structures. 

The following sections describe each of the devices listed in the 
table above. The sections are in alphabetic order by generic device 
type (thus PCDP: and CDR: are listed under "c" )• 



2.4.1 Physical Card Reader (PCDR:) 

The following device-dependent status bits are defined for the card 
reader. These bits can be obtained with the .MOPST function of the 
MTOPR call. 
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Table 2-4 
PCDR: Status Bits 



Bit 


Symbol 


Meaning 


BO 


MO%COL 


Device is on line. 


BIO 


MO%FFP 


Fatal hardware error. This error generates 
an interrupt on software channel .ICDAE. 
(Pefer to Section 2.6.1.) 


B12 


MO%EOF 


Card reader is at end of file. 


B13 


MO%IOP 


I/O in progress. 


B14 


MO%SER 


Software error. (Would generate an 
interrupt on an assignable channel.) 


B15 


MO%HE 


Hardware error. (Would generate an 
interrupt on software channel .ICDAE.) 


B16 


MO%OL 


Device is off line. 


B17 


MO%FNX 


Device is nonexistent. 


B31 


MO%SFL 


Output stacker full. 


B32 


MO%HEM 


Input hopper empty. 


B33 


MO%SCK 


Stack check. 


B34 


MO%PCK 


Pick check. 


B35 


MO%PCK 


Pead check. 



2.4.2 Spooled Card Reader (CDR:) 

On most systems, the physical card reader devices (PCDR: devices) are 
under the control of the card reader spooler, SPRINT, and thus the 
ordinary user cannot open a PCDR: device, and must instead open a 
spooled card reader device (CDR:). 

When a GTJFN is performed on device CDR:, the device characteristics 
(returned by DVCHP) are the same as those for device PCDR:. Thus, 
CDR: devices have units, and a unit number may be specified for the 
GTJFN. 

When the OPENF is performed, However, the device characteristics 
become the same as device DSK:. This is because data read from device 
CDR: is actually read from a file in the spool directory <SPOOL>. The 
file is spooled from the PCDR: device to the spool directory by 
SPRINT. 

Thus device CDR: is effectively a disk device, and no monitor call 
that can be used only to set the characteristics of a PCDR: device can 
be used for a CDR: device. Also, disk-only operations (such as PMAP) 
should not be done for a CDR: device. Both ASCII and image mode are 
supported for CDR: devices. 



2-34 



FUNCTIONAL ORGANIZATION OF JSYS'S 



2.4.3 Physical Card Punch (PCDP:) 

The following device-dependent bits are defined for the card reader. 
These functions can be obtained with the .MORST function of the MTOPR 
monitor call. 



Table 2-5 
PCDP: Status Bits 



Bit 


Symbol 


Meaning 


BIO 


MO%FER 


Fatal error condition 


B12 


MO%EOF 


All pending output has been processed 


B13 


MO%IOP 


Output in progress 


B14 


MO%SER 


Software error has occurred (would generate 
interrupt on an assignable channel) 


B15 


MO%HE 


Hardware error has occurred (would generate 
interrupt on channel .ICDAE) 


B16 


MO%OL 


Card-punch is off-line. This bit is set 
when operator intervention is reauired (card 
jam, hopper empty, stacker full) . 


B17 


MO%FNX 


Card punch doesn't exist. 


B32 


MO%HEM 


Stacker is full or hopper is empty 


B33 


MO%SCK 


Stacker is full or hopper is empty (same as 
above) 


B34 


MO%PCK 


Pick check 



2.4.4 Spooled Card Punch (CDP:) 

On most systems, the physical card punch devices (PCDP: devices) are 
under the control of the card punch spooler, SPPOUT, and thus the 
ordinary user cannot open a PCDP: device, and must instead open a 
spooled card punch device (CDP:). 

When a GTJFN is performed on device CDP:, the device characteristics 
(returned by DVCHR) are the same as those for device PCDP:. Thus, 
CDP: devices have units, and a unit number may be specified for the 
GTJFN. However, when the OPENF is performed, the device 
characteristics become the same as device DSK:. This is because data 
written to device CDP: is actually written to a file in the spool 
directory <SPOOL>. The file is then spooled from the spool directory 
to the PCDP: device by SPPOUT. 

Thus device CDP: is effectively a disk device, and no monitor call 
that can be used only to set the characteristics of a PCDP: device can 
be used for a CDP: device. Also, disk-only operations (such as PMAP) 
should not be done for a CDP: device. Both ASCII and image mode are 
supported for CDP:: devices. 
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2.4.5 Physical Line Printer (PLPT:) 

The line printer normally accepts the 128 7-bit ASCII character codes 
(0-177 octal). However, by specifying a byte size of 8 when opening 
the printer, a program can transfer 8-bit bytes. Thus, the program 
can take advantage of printers that have more than 128 characters. 

Each code sent usually causes a graphic to be printed. (Note that on 
a 64-character printer, lower case letters are represented as upper 
case.) However, the carriage control characters do not cause a graphic 
to be printed; instead they cause specific actions to be taken. The 
actions taken are determined by the translation RAM and the Vertical 
Formatting Unit. These actions can be redefined by the installation, 
and the method by which they are redefined depends on the type of 
printer being used. 

For the LP10 printer, which has a carriage control tape, the 
installation must change the tape to redefine the resulting actions. 

For the LP05 and LP14 printers, which have a direct access Vertical 
Formatting Unit and a programmable translation RAM, the installation 
can redefine the resulting actions by: 

1. Peprogramming the VFU by changing the VFU file with the 
MAKVFU program and reloading this file and the RAM. 

2. Reprogramming the translation RAM by changing the RAM file 
with the MAKRAM program and reloading this file. 

Refer to the LPINI and MTOPR monitor calls for the functions used in 
loading the VFU and RAM files. 

The default actions taken on the carriage control characters, along 
with the default channels that determine these actions, are as 
follows : 
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Table 2-6 
PLPT: Control Characters 



ASCII Character 


Default 


Name 


Default 


Code 


Channel 




Action 


11 




Tab 


No vertical motion. 
Skips to the beginning 
of every 8th column on 
the same line. 


12 


8 


Line feed 


Skips to column 1 on the 
next line. The last six 
lines of each page are 
skipped. 


13 


7 


Vertical tab 


Skips to column 1 on the 
line at the next third 
of a page. 


14 


1 


Form feed 


Skips to column 1 on the 
top of the next page. 


15 




Carriage 








return 


No vertical motion. 
Returns to column 1 of 
the current line and 
does not advance the 
paper . 


20 


2 


Half page 


Skips to column 1 on the 
next half page. 


21 


3 


Alternate 


■ 






lines 


Skips to column 1 on the 
next even line. 


22 


4 


Three lines 


Skips to column 1 on the 
next of every third 
line. 


23 


5 


Next line 


Skips to column 1 on the 
next line without 
skipping the last six 
lines on a page. 


24 


6 


Sixth page 


Skips to column 1 on the 
next sixth of a page. 



The association between the ASCII code and the channel is determined 
by the RAM. The association between the channel and the default 
action is determined by the VFU. Therefore, a change in the VFU 
changes the association between the channel and the action, which 
causes the ASCII code to be associated with the new action. 
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2.4.5.1 PLPT: Status Bits - The following device-dependent status 
bits are defined for the line printer. These bits can be obtained 
with the .MORST function of the MTOPR call. 



Table 2-7 
PLPT: Status Bits 



Bit 


Symbol 


Meaning 


BO 


MO%LCP 


Lower case printer 


BIO 


MO%FER 


Fatal hardware error. This error generates an 
interrupt on software channel .ICDAE (refer to 
Section 2.6.1) . 


B12 


MO%EOF 


All data sent to the printer has actually been 
printed . 


B13 


MO%IOP 


I/O in progress 


B14 


MO%SER 


Software error (e.g., interrupt character, page 
counter overflow) 


B15 


MO%HE 


Hardware error. Forms must be realigned. This 
error generates an interrupt on software 
channel .ICDAE. 


B16 


MO%OL 


Device is off line 


B17 


MO%FNX 


Device is nonexistent 


B30 


MO%RPE 


RAM parity error 


B31 


MO%LVU 


Optical VFU 


B33 


MO%LVF 


VFU error 


B34 


MO%LCI 


Character interrupt. This generates an 
interrupt on channel .ICDAE. 


B35 


MO%LPC 


Page counter register overflow 



2.4.6 Spooled Line Printer (LPT:) 

On most systems, the physical line printer devices (PLPT: devices) 
are under the control of the line printer spooler, LPTSPL and thus 
the ordinary user cannot open a PLPT: device and must, instead, open 
a spooled line printer device (LPT:) 

When a GTJFN is performed on device LPT:, the device characteristics 
(returned by DVCHR) are the same as those for device PLPT:. Thus, 
LPT: devices have units, and a unit number may be specified for the 
GTJFN. However, when the OPENF is performed, the device 
characteristics become the same as device DSK:. This is because 
data written to device LPT: is actually written to a file in the 
spool directory PS:<SPOOL>. When device LPT: is closed, the file in 
<SPOOL> is closed and a message sent to the line printer spooler 
LPTSPL causing it to print the file on the line printer. 
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Thus device LPT: is effectively a disk device, and none of the 
monitor calls that can be used only to set the characteristics of a 
PLPT: device can be used for a LPT: device. Also, disk-only 
operations (such as PMAP) should not be performed for LPT: devices. 
Note that LPTSPL writes only 7-bit bytes, so opening a LPT: device 
with any other byte size will cause erroneous results. Also, only 
ASCII mode is supported for LPT: devices. 



2.4.7 Physical Magnetic Tape (MTA:) 

The following device-dependent bits are defined for magnetic tape 



Table 2-8 
MTA: Status Bits 



Bit 


Symbol 


Meaning 


18 


MT%ILW 


Drive is write protected 


19 


MT%DVE 


Device error (hung or data late) 


20 


MT%DAE 


Data error 


21 


MT%SER 


Suppress automatic error recovery procedures 


22 


MT%EOF 


Device EOF (file) mark 


23 


MT%IRL 


Incorrect record length (not the same number of 
words as specified by the read operation or not 
a whole number of words) 


24 


MT%BOT 


Beginning of tape 


25 


MT%EOT 


End of tape 


26 


MT%EVP 


Even parity 


29-31 


MT%CCT 


Character counter if MT%IRL is on. In the case 
of an error generated by an incorrect record 
length, this field contains the number of bytes 
actually transferred. 


32 


MT%NSH 


The selected data mode or density is not. 
supported by the hardware (such as using 
ANSI-ASCII mode on a TM03 controller) . 



Data transfers to and from the magnetic tape can be performed using 
either buffered or unbuffered I/O. 
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2.4.7.1 Buffered I/O - The monitor uses buffered I/O when the 
sequential I/O calls (e.g., BIN/BOUT, SIN/SOUT) are used to read from 
or write to the magnetic tape. When the tape is opened for sequential 
I/O (data mode .GSNRM on the OPENF call) , the monitor reserves buffer 
space large enough to hold two records of data. The maximum size of 
the records is specified with the SET TAPE RECORD-LENGTH command or 
the .MOSRS function of the MTOPR monitor call. The maximum record 
lengths for magnetic tapes supported by TOPS-20 are listed in the 
description of the .MOSRS function of the MTOPR monitor call. The 
buffers reserved by the monitor allow the user's program to overlap 
computation with the transfer of data to and from the tape. 

The BIN monitor call is used to read one byte from the tape, with the 
monitor filling one buffer with data as the user program is reading 
bytes from the other buffer. A program reading data from the tape 
with successive BIN calls obtains a stream of bytes until a tape mark 
is read. The SIN monitor call is used to read a speciried number of 
bytes with the monitor again performing the double buffering. Both 
the BIN and the SIN calls read across record boundaries on the tape. 
The SINR monitor call is used to read variable-length records from the 
tape because each call returns one record to the user program. If the 
record on the tape contains more data than the SINR call requests, the 
remaining bytes in the record are discarded. The SINR call never 
reads across record boundaries on the tape. Thus, each SINR call 
begins reading at the first byte of the next record on the tape. With 
all three calls, the specified record size must be at least as large 
as the largest record being read from the tape. 



The BOUT monitor call is used to write one byte on the tape. A 
program writing data on the tape with successive BOUT calls writes a 
stream of bytes packed into records of the specified size. The SOUT 
monitor call is used to write a specified number of bytes into one 
record equal to the given record size. The SOUTR call is used to 
write variable-length records on the tape because each call writes at 
least one record. The size of the record is equal to either the 
number of bytes specified in the SOUTR call or the number of bytes 
specified in the maximum record size, whichever is smaller. If the 
number of bytes requested in the call is greater than the specified 
record size, then records of the maximum size are written, plus 
another record containing the remaining bytes. If the end of tape 
marker is reached during sequential mode output, the data is written 
and an error return is given. Bit MT%EOT (bit 25) in the device 
status word will be set to indicate this condition. 

When a CLOSF monitor call is executed for a magnetic tape to which 
buffered output is being done, any data remaining in the monitor's 
buffers will be written to the tape. The monitor writes two tape 
marks after the last record written and backspaces over the second 
mark. This allows a subsequent write operation to overwrite the last 
tape mark, and always leaves two tape marks (a logical end of tape) 
after the last record written. 

The monitor does not write records of less than four words long. Thus 
if the user requests less than four words to be written on a SOUTR or 
DUMPO (see below) call, the monitor writes a four-word record, 
completing it with zeros. On a SOUT call, if less than four words 
remain in the buffer at the time of the CLOSF call, the monitor again 
fills the record with zeros. 
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2.4.7.2 Unbuffered I/O - The DUMPI and DUMPO monitor calls are used 
to read from or write to the magnetic tape without using buffered I/O. 
(Unbuffered I/O is sometimes called dump mode I/O.) Unbuffered I/O 
uses a program-supplied command list to determine where to transfer 
data into or out of the program's address space. The command list can 
contain three types of entries: 

1. IOWD n, loc transfers n words from loc through loc+n-1. The 
next command is obtained from the location following the 
IOWD. Each IOWD word reads or writes a separate magnetic 
tape record. 

2. XWD 0/ y takes the next command from location y. 

3. terminates the command list. 

Refer to the DUMPI call description for more information. 

On input, a new record is read for each IOWD entry in the command 
list. If the IOWD request does not equal the actual size of the 
record on the tape, an error (IOX5) is returned. The GDSTS monitor 
call can then be executed to examine the status bits set and to 
determine the number of bytes transferred. In addition, if a tape 
mark is read, an error (IOX4) is returned. On output, a new record is 
written for each IOWD entry in the command list. 

There are two modes available in unbuffered I/O. In the normal mode, 
the monitor waits for the data transfer to complete before returning 
control to the program. In the no-wait mode, the monitor returns 
control immediately after queuing the first transfer so that the 
program can set up the second transfer. The monitor then waits for 
the first transfer to complete before queuing the second. If the 
first transfer is successful, the second one is started, and control 
is returned to the program. If the first transfer is not successful, 
an error is returned in AC1, and the second one is not started. The 
desired mode is specified by bit DM%NWT in AC1 on the DUMPI or DUMPO 
call. 



2.4.7.3 Magnetic Tape Status - The status word of a magnetic tape can 
be obtained with the GDSTS call or individual status bits can be 
obtained with the MTOPR call. The GDSTS call waits for all activity 
to stop during sequential mode output, dump mode, and spacing 
operations before obtaining the status. A GDSTS call executed during 
sequential mode input returns the status of the current record. 

Reading from or writing to a magnetic tape cannot be done if there are 
any errors set in the device status word. The program can clear 
errors with the SDSTS call or the .MOCLE function of the MTOPP call. 



2.4.7.4 Reading a Tape in the Reverse Direction - With the .MOSDR 
function of the MTOPR call, the program can cause the tape to move in 
the reverse direction (toward the beginning of the tape) during read 
operations. The data in each record are returned in the forward 
order, but the records themselves are returned in the reverse order. 
The sensing-foil marking the beginning of tape is treated as an EOF 
tape mark. 
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When the SIN call is used to read data in the reverse direction, the 
byte size and record length specified in the call should equal the 
byte size and record length of the records on the tape. If the record 
characteristics specified in the call do not equal the characteristics 
of the records on tape, the bytes are returned out of phase with the 
bytes in the tape record. 

When the SINR call is used to read data in the reverse direction, the 
number of bytes requested by the call should be at least as large as 
the size of the record on the tape. If the requested number is 
smaller than the number of bytes in the tape record, the remaining 
bytes in the record are discarded from the beginning of the record and 
not from the end of the record. 



2.4.7.5 Hardware Data Modes - By using the .MOSDM function of the 
MTOPR call, the program can set the mode for storing data on a 
magnetic tape. The following descriptions indicate how bits are 
stored in the tracks and the number of frames reauired to store a 
36-bit word of data. 

The parity bit is represented in the diagrams by "P" . 

NOTE 

Data undergoes 2 transformations before 
it is actually written to magnetic tape. 
The first transformation occurs when a 
word of data is formed into frames by 
the tape controller. The formats of 
these frames are illustrated in the 
diagrams below. 

A second transformation occurs when the 
tape drive receives a frame of data from 
the controller, and physically writes 
that frame to tape: the bits within the 
frame are rearranged and then written. 
This final format is standardized 
throughout the computer industry and is 
designed to (among other things) place 
the parity bit in the center of the tape 
(the "safest" part of the tape). 
Because this final format is 
standardized, it is "invisible" and does 
not affect user programs in any way. 

Programmers who must deal with the 
problem of transferring data between DEC 
machines and the machines of other 
vendors need only concern themselves 
with the formats shown below. Thus, 
while it is technically incorrect to 
think of the diagrams below as showing 
the physical format of a word stored on 
magnetic tape, it is convenient to do 
so, and this simplification is made in 
this manual. 
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Unbuffered (Dump) Mode 

This mode stores a word of data as a 36-bit byte in five frames of a 
9-track tape. Note that the fifth frame is partially used. This mode 
is normally the default mode. 
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Industry Compatible Mode 

This mode stores a word of data as four 8-bit bytes in four frames of 
a 9-track tape. On a read operation, four frames of 8-bit bytes are 
read, left- justified , into a word. The remaining four bits of the 
word are 0, or are copies of the parity bits, depending on the 
hardware; these bits are not data. On a write operation, the 
leftmost four 8--bit bytes (i.e., bits through 31) of the word are 
written in four frames on the tape. The rightmost four bits (i.e., 
bits 32 through 35) of the word are ignored and are not written on the 
tape. This mode is compatible with any machine that reads and writes 
8-bit bytes. 
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ANSI ASCII Mode 

This mode stores a word of data as five 7-bit bytes in five frames of 
a 9-track tape. On a read operation, five frames of 7-bit bytes are 
read, left- justif Led , into a word. The remaining bits (bits 35) of 
each frame are ORed together, and the result is placed in bit 35 of 
the word. On a write operation, the leftmost five 7-bit bytes of the 
word are written in five frames on the tape. Bit 35 of the word must 
be zero to conform to ANSI standards. It is written into the 
high-order bit of the fifth frame, and the remaining high-order bits 
of the first four frames are 0. This mode is useful when transferring 
ASCII data from TOPS-20 to machines that read 8-bit bytes. This mode 
is available on any 9-track drive connected to a TM02 or DX20 tape 
controller . 
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SIXBIT Mode 

This mode stores a word of data as six 6-bit bytes in six frames of a 
7-track tape. This mode is the only supported hardware mode for 
7-track tapes. 

FRAMES 
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P 6 

High Density Mode 

In this mode, two 36-bit words are stored in 9 frames. High density 
mode is available on any 9-track drive connected to a DX20 controller. 

TRACKS FRAMES 
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2.4.8 Logical Magnetic Tape (MT:) 

Logical magnetic tape devices are used so that the system operator can 
fulfill a MOUNT request with any available tape drive that meets the 
requirements of the MOUNT request. The user never knows and need not 
know which physical drive (MTA:) is mapped to the logical drive (MT:). 

Some JSYS functions available for MTA : devices are not available for 
MT: devices. Also, MT: devices are commonly used in a tape-labeled 
environment which causes further restrictions in the JSYS functions 
available for MT: devices. See the appropriate JSYS's for any 
restrictions that may apply. 



2.4.9 Terminal (TTY:) 

Most monitor calls in this group return an error if the device 
referenced is assigned to another job. However, a process with WHEEL 
capability enabled can reference a terminal assigned to another job 
(as controlling terminal or with ASND) . The monitor calls pertaining 
to terminals have no effect, or return default-value information, when 
used with other devices. 

The following status bits are defined for TTY's. 

Bit Symbol Meaning 

B35 GD%PAR The TTY will tolerate a parity bit. Any program 

producing binary output for a TTY should check 
this bit to determine if it should apply parity. 
If parity is to be applied, the TTY must be opened 
with an 8-bit bytesize; otherwise, a 7-bit 
bytesize must be used. 

DECNET NVT's will not accept a parity bit. 



2.4.9.1 JFN Mode Word - Each terminal in TOPS-20 is associated with a 
mode word. This word can be read with the RFMOD call and changed with 
the SFMOD and STPAR calls. The SFMOD call affects only the modes that 
are program- 1 related : wakeup control, echo mode, and terminal data 
mode; thus a program can execute a SFMOD call without affecting 
previously- | established device modes. The STPAR call, on the other 
hand, affects fields that describe device parameters (mechanical 
characteristics, page length and width, case conversion, and duplex 
control). Table 2-9 shows the format of the JFN mode word. 
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Table 2-9 
JFN Mode Word 



Bit 


Symbol 


Changed by 


Function 





TT%OSP 


SFMOD 


output suppress control (l=ignore 
output; 0=allow output) 


1 


TT%MFF 


STPAR 


has mechanical form feed 


2 


TT%TAB 


STPAR 


has mechanical tab 


3 


TT%LCA 


STPAP 


has lower case 


4-10 


TT%LEN 


STPAP 


page length 


11-17 


TT%WID 


STPAR 


page width 


18-2 3 


TT%WAK 


SFMOD 


wakeup control on: 
B18: not used 




TT%IGN 




B19: ignore the other TT%WAK bits 




TT%WKF 




B20: formatting control character 




TT%WKN 




B21: non-formatting control character 




TT%WKP 




B22: punctuation character 




TT%WKA 




B23: alphanumeric character 


2 4 


TT%ECO 


SFMOD 


echos on 


2 5 


TT%ECM 


STPAR 


echo mode 


2 6 


TT%ALK 


TLINK 


accept links 


27 


TT%AAD 


TLINK 


accept advice 


28-29 


TT%DAM 


SFMOD 


terminal data mode 




.TTBIN 




00 


no translation 




.TTASC 




01 


translate both echo and output 




.TTATO 




10 


translate output only 




.TTATE 




11 


translate echo only 


3 


TT%UOC 


STPAR 


upper case output control 
0: do not indicate 
1: indicate by 'X 


31 


TT%LIC 


STPAP 


lower case input control 

0: no conversion 

1: convert lower to upper 


3 2-33 


TT%DUM 


STPAR 


duplex mode 




.TTFDX 




00 


Full duplex 




•TTHDX 




10 


Character half duplex 




.TTLDX 




11 
01 


Line half duplex 
Reserved for DEC 


34 


TT%PGM 


STPAP 


pause-on-command mode (l=enable 
pause-on-command mode, 0=disable 
pause-on-command mode.) 

This function enables/disables the 
TOPS-20 feature that allows a user to 
manually stop TTY output with ~S and 
resume it with ~Q. See MTOPR function 
.MOXOF for pause-a t-end-of-page mode. 


3 5 


TT%CAR 




system carrier state; on if line is a 
dataset and the carrier is on. 



Bit (TT%OSP) implements the CTRL/O function. If this bit is set, 
all program output directed to the terminal is discarded. When the 
bit is off, program output is buffered and sent as usual. The current 
contents of the output buffer are not cleared when this bit is set; 
clearing the buffer must be done explicitly (by means of the CFOBF 
call) if output is to be stopped immediately. Any input function 
clears this bit. 
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Bits 1, 2, and 3 (TT%MFF, TT%TAB, and TT%LCA) define several of the 
mechanical capabilities of the terminal and affect character handling 
on both input and output.. Form feeds and tabs are simulated if the 
terminal does not have the required mechanical capability, or if 
simulation has been requested by the SFCOC call. 

Bits 4-10 (TT%LEN) determine the number of line feeds necessary to 

simulate a formfeed, or the number of lines to fit on the display 

screen. A value means the declared length of the page is 
indefinitely large. 

Bits 11-17 (TT%WID) determine the point at which the output line must 
be continued on the next line by inserting a carriage return-line 
feed. If 0, no line folding occurs. 

Bits 18-23 (TT1WAK) define the particular class of characters that, 
when input from the terminal, will wake up a waiting program. Refer 
to Section 2.4.9.3 for the definitions of the wakeup classes. Note 
that the class-wakeup scheme is maintained for compatibility with 
older programs. Newer programs should use the .MOSBM function of the 
MTOPR JSYS as it has more resolution and causes less system load. 

Bit 24 (TT%ECO) defines if echos are to be given. If this bit is off, 
echoing is turned off. This is useful when the program is accepting a 
password or is simulating non-standard echoing procedures. 

Bit 25 (TT%ECM) defines when the echo will occur. If this bit is off, 
the echo will occur when the program reads the character. That is, 
the echo occurs immediately if the program is waiting for input or is 
deferred if the program is not waiting for input. This is the 
standard echo mode which produces a correctly ordered typescript 
(i.e., program input and output appear in the order in which they 
occurred). If this bit is on, the echo occurs as soon as the 
character is typed. Note that this mode may cause editing to appear 
out of order on the typescript. This occurs because editing is 
performed as the program reads the character and not necessarily when 
the echo occurs. 

Bits 28-29 (TT%DAM) define the terminal data mode. The four possible 
data modes are: 

00 Binary (.TTBIN), 8-bit input and output. There is no format 
control or control group translation and no echoing. 
However, "S and "Q are still under control of TT%PGM. 

01 ASCII (.TTASC), 7-bit input and output, plus parity on for 
control group output. There is format control as well as 
simulation and translation of control group for input (echo) 
and output according to the control words given on the SFCOC 
JSYS. This is the usual terminal data mode. 

10 Disable the translation of echo (.TTATO). In all other 
respects, same as .TTASC. 

11 Disable the translation of output (.TTATE). Obeys the CCOC 
word on input only. In all other respects, same as .TTASC. 

The last two data modes allow the user to selectively disable the 
translation of control characters for input or output. When 
translation is disabled, control characters are always sent. 
Simulation of formatting control characters is still performed if 
requested by the control words of the PFCOC or SFCOC JSYS or if the 
device does not have the required mechanical capability. The 
translation typically results in some control characters being 
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indicated by graphics instead of being sent as is. For example, 
disabling the translation of output characters is appropriate for some 
display terminals when the program must send untranslated control 
characters to control the display, but requires that the control 
characters typed by the user be indicated in the usual way. 

Bit 30 (TT%UOC) specifies that upper case terminal output is to be 
indicated by 'X (single quote preceding character that is upper case) 
if TT%LCA is not set. This is primarily intended for terminals that 
are not capable of lower case output. 

Bit 31 (TT%LIC) specifies that lower case terminal input is to be 
translated to upper case and that codes 175 and 176 are to be 
converted to code 33. This is useful for older terminals that send 
codes 175 or 176 in response to the ALT or ESC key. 

Bits 32-33 (TT%DUM) define the three duplex modes presently available. 
Full duplex (.TTFDX) requires the system to generate the appropriate 
echo for each character typed in. Character half duplex (.TTHDX) 
assumes the terminal will internally echo each character typed but 
will require an additional echo for formatting characters such as 
carriage return. Line half duplex (.TTLDX) is similar to character 
half duplex but does not generate a line feed echo after a carriage 
return. 

Bit 34 (TT%PGM) specifies the output mode. In display mode, the user 
can create a pause in the output while he reads material that would 
otherwise quickly disappear off the screen. The output is stopped 
with the CTRL/S character and started with the CTRL/Q character. 
Also, output automatically stops whenever a page, as defined by 
TT%LEN, has been output; output is resumed with CTRL/Q. 

Bit 35 (TT%CAR) indicates the carrier state. If the line is a 
dataset, this bit is on if the carrier is on. If the line is not a 
dataset, this bit is undefined. 



2.4.9.2 Control Character Output Control - Each terminal has two 
control character output control (CCOC) words. Each word consists of 
2-bit bytes, one byte for each of the control characters (ASCII codes 
0-37) . The bytes are interpreted as follows: 



00 
01 
10 
11 



ignore (send nothing) 

indicate by "X (where X is the character 

send character code 

simulate format action 



The RFCOC and SFCOC monitor calls read and manipulate the CCOC words. 
Table 2-10 lists the ASCII code for each character. 



2.4.9.3 Character Set - The following information describes each 
character in the TOPS-20 character set that is pertinent to the 
monitor calls in this group. The wakeup class (refer to TT%WAK in 
Section 2.4.9.1) is abbreviated as follows: 



F formatting control character 

C non-formatting control character 

P punctuation character 

A alphanumeric character 
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Refer to Section 2.4.9.2 for the explanation of the control character 
output control (CCOC) words. 

The following table lists the wakeup classes for the TOPS-20 character 
set (ASCII) : 



Table 2-10 
Wake-up Classes/CCOC Word Bits 



ASCII 


Wake-up 


CCOC 


Character or Control Character 


Code 


Class 


Word (bits) 







C 


1(B0,1) 


CTRL/@ null, break 


1 


C 


1(62,3) 


CTRL/A 


2 


C 


1(B4,5) 


CTRL/B 


3 


C 


1(B6,7) 


CTRL/C 


4 


C 


1(B8,9) 


CTRL/D 


5 


C 


l(B10 f ll) 


CTRL/E 


6 


C 


1 (B12,13) 


CTRL/F 


7 


C 


1(B14,15) 


CTRL/G bell 


10 


F 




1(B16,17) CTRL/H backspace 


11 


P 




1(B18,19) CTRL/I horizontal tab 


12 


F 




1(B20,21) CTRL/J line feed 


13 


C 




1(B22,23) CTRL/K vertical tab 


14 


F 




1(B24,25) CTRL/L form feed 


15 


F 




1(B26,27) CTRL/M carriage return 


16 


C 




1(B28,29) CTRL/N 


17 


C 




1(B30,31) CTRL/O 


20 


C 




1(B32,33) CTRL/P 


21 


C 




1(B34,35) CTRL/Q 


22 


C 




2(B0,1) CTRL/R 


23 


C 




2(B2,3) CTRL/S 


24 


C 




2(B4,5) CTRL/T 


25 


C 




2(B6,7) CTRL/U 


26 


C 




2(B8,9) CTRL/V 


27 


C 




2 (B10, 11) CTRL/W 


30 


C 




2(812,13) CTRL/X 


31 


C 




2(B14,15) CTRL/Y 


32 


c 




2(B16,17) CTRL/Z 


33 


all 




2(B18,19) escape (altmode) 


34 


C 




2(B20,21) CTRL/backslash 


35 


C 




2(B22,23) CTRL/right square bracket 


36 


C 




2(B24,25) CTRL/uparrow 


37 


F 




2(B26,27) CTRL/backarrow 


40 


P 




space 


41 


P 




i 


42 


P 




ii 


43 


P 




# 


44 


P 




$ 


45 


P 




% 


46 


P 




& 


47 


P 




■ 


50 


P 




( 


51 


P 




) 


52 


P 




* 


53 


P 




+ 


54 


P 




, 
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Table 2-10 (Cont.) 
Wake-up Classes/CCOC Word Bits 



ASCII 


Wake-up 


CCOC 


Character or Control 


Character 


Code 


Class 


Word (bits) 






55 


P 








56 


P 




. 




57 


P 




/ 




60-71 


A 




0-9 




72 


P 




: 




73 


P 




/ 




74 


P 




< 




75 


P 




= 




76 


P 




> 




77 


P 




? 




100 


P 




@ 




101-13 2 


A 




upper case letters 


A-Z 


13 3 


P 




[ 




134 


P 




\ 




135 


P 




] 




136 


P 




^ 




137 


P 








140 


P 




accent (grave) 




141-172 


A 




lower case letters 


a-z 


173(1) 


P 




left brace 




174(1) 


P 




vertical bar 




175(1) 


P 




right brace 




176(1) 


P 




til de 




177 


all 




delete (rubout) 





NOTE 



ESC(33) and 
considered to 
classes. 



DELETE(177) 
be in all 



are 
wake up 



2. If the terminal has B31(TT%LIC) on 
in the JFN mode word, codes 175 and 
176 are converted to code 33 on 
input. 

3. The class-wakeup scheme is 
maintained for compatibility with 
older programs. New programs should 
use the .MOSBM function of the MTOPP 
JSYS as it has more resolution (it 
allows a 4-word character mask to 
specify individual wakeup 
characters) and causes less system 
load (low-level monitor I/O routines 
are subjected to fewer wakeups) . 
Both SFMOD and .MOSBM set the same 
mask; however SFMOD computes wakeup 
classes from the mask while .MOSBM 
uses character-oriented wakeups. 
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2.4.9.4 Terminal Characteristics Control - The various types of 
terminals have different characteristics for output processing, 
depending on their type and speed. The characteristics that can be 
associated with terminals are: 

1. mechanical form feed and tab 

2. lower case 

3. padding after carriage return 

4. padding after line feed 

5. padding after mechanical tab 

6. padding after mechanical form feed 

7. page width and length 

8. cursor commands 

Instead of setting each of these parameters for his line, the user can 
specify a terminal type number, which causes the appropriate 
parameters to be set. Refer to the STTYP monitor call. The defined 
terminal types, along with their characteristics, are listed below. 



Table 2-11 
Terminal Characteristics 



Number 



Terminal 



Symbol 



Character istics 



TTY model 33 



TTY model 35 



TTY model 37 



TI/EXECUPORT 



4-7 



TT3 3 



TT3 5 



.TT3 7 



.TTEXE 



no mechanical form feed or tab, has 
upper case only, no padding after 
carriage return and line feed, 
padding after tab and form feed, 
page width 72, page length 66 

has mechanical form feed and tab, 
has upper case only, no padding 
after carriage return and line 
feed, padding after tab and form 
feed, page width 72, page length 66 

no mechanical form feed or tab, 
lower case, no padding after 
carriage return and line feed, 
padding after tab and form feed, 
page width 72, page length 66 

no mechanical form feed or tab, 
lower case, padding after carriage 
return only page width 80, page 
length 66 

reserved for customer 
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Table 2-11 (Cont.) 
Terminal Characteristics 



Number 


Terminal 


Symbol 


Characteristics 


10 


Default 


.TTDEF 


no mechanical form feed or tab, 
lower case, full padding, page 
width 72, page length 66 


11 


Ideal 


.TTIDL 


has mechanical form feed and tab, 
lower case, no padding, no 
specified width and length 


12 


VT0 5 


.TTV05 


no mechanical form feed, has 
mechanical tab, has upper case 
only, no padding after carriage 
return and tab, padding after line 
feed and form feed, page width 72, 
page length 20, has cursor commands 


13 


VT50 


.TTV5 


no mechanical form feed or tab, has 
upper case only, no padding, page 
width 80, page length 12, has 
cursor commands 


14 


LA30 


.TTL30 


no mechanical form feed or tab, has 
upper case only, full padding, page 
width 80, page length 66 


15 


GT40 


.TTG4 


no mechanical form feed or tab, lower 
case, no padding, page width 80, page 
length 30 


16 


LA36 


.TTL36 


no mechanical form feed or tab, lower 
case, no padding, page width 132, 
page length 66 


17 


VT5 2 


.TTV52 


no mechanical form feed, has 
mechanical tab, lower case, no 
padding, page width 80, page length 
24 


20 


VT100 


.TT100 


no mechanical form feed, has 
mechanical tab, lower case, no 
padding, page width 80, page length 
24, has cursor commands 

When used in VT52 mode, the terminal 
type should be set to .TTV52. 


21 


LA38 


.TTL38 


no mechanical form feed, has 
mechanical tab, lower case, no 
padding, page width 132, page length 
66 
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Table 2-11 (Cont.) 
Terminal Characteristics 



Number 


Terminal 


Symbol 


Characteristics 


22 
35 

36 


LA120 
VT125 

VK100 


.TT120 
.TT12 5 

.TTK10 


has mechanical form feed and tab, 
lower case, no padding, page width 
132, page length 60 

no mechanical form feed, has 
mechanical tab, lower case, no 
padding, page width 80, page length 
24, has cursor commands and graphics 
capabilities 

no mechanical form feed, has 
mechanical tab, lower case, no 
padding, page width 80, page length 
24, has cursor commands and color 
graphics capabilities 



The STTYP monitor call sets the terminal type number for a 
the GTTYP monitor call obtains the terminal type number. 



line, and 



2.4.9.5 Terminal Linking - It is possible to link the output: of any 
line to up to four other lines. The refuse/accept link bit TT%ALK 
(bit 26) in the JFN mode word controls terminal linking. If the bit 
is off for a particular terminal, a user cannot link to that terminal 
unless the user has WHEEL or OPERATOR privileges enabled. Although 
this bit can be read with the RFMOD monitor call, the bit can only be 
set with the TLINK call. 

Refer to the TLINK monitor call for a description of terminal linking. 



2.4.9.6 Terminal Advising - It is possible to receive advice from any 
terminal line in the system. The refuse/accept advice bit TT%AAD (bit 
27) in the JFN mode word controls terminal advising. If this bit is 
off for a particular terminal, users cannot simulate typing on that 
terminal by means of the STI monitor call unless the user has WHEEL or 
OPERATOR privileges enabled. Although this bit can be read with the 
RFMOD monitor call, it can only be set with the TLINK call. 



Refer to the 
advising . 



TLINK monitor call for 



description of terminal 
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The following monitor calls are used for device control: 

ASND Assigns a device 

RELD Releases a device 

SPOOL Defines and initializes input spooling 

LPINI Loads VFU or translation RAM 

DVCHR Returns device characteristics 

GDSTS Returns the device status 

SDSTS Sets the device status 

GDSKC Returns disk usage 

MSTR Performs structure-dependent functions 

MTOPP Performs device-dependent functions 

MTU% Performs functions for logical tape devices 

(MT: devices) 

STDEV Translates a string to a device designator 

DEVST Translates a device designator to a string 

GTTYP Returns terminal type number 

STTYP Sets terminal type number 

ATACH Attaches controlling terminal to a job 

DTACH Detaches controlling terminal from a job 

TLINK Controls terminal linking 

RFMOD Returns the JFN mode word 

SFMOD Sets program-related fields in the JFN mode word 

STPAR Sets device-related fields in the JFN mode word 

RFPOS Returns current position of the terminal 

SFPOS Sets current position of the terminal 

RFCOC Returns control character output control words 

SFCOC Sets control character output control words 

CFIBF Clears terminal's input buffer 

CFOBF Clears terminal's output buffer 

SIBE Skips if input buffer is empty 

SOBE Skips if output buffer is empty 

SOBF Skips if output buffer is full 

DIBE Dismisses until terminal input buffer is empty 

DOBE Dismisses until terminal output buffer is empty 



2.5 SOFTWARE DATA MODES 

I/O may be performed in one of several modes, depending on the device. 
(The mode is specified with the OPENF call.) The range of possible I/O 
modes is from to 17 (octal). However, except for ARPANET devices 
and less common hardware devices (such as paper-tape punches/readers) 
the only meaningful modes are 0, 10, and 17. 

The following discussion lists the major devices supported by TOPS-20 
and the applicable I/O modes: 

Device Mode Symbol Explanation 

CDP: 
PCDP: .GSNPM Normal mode - allows unit-record output. 

For card punches, this mode converts each 
7-bit ASCII character to a 12-bit 
card-column code (Hollerith code) and 
outputs that code to the device. 

1 .GSSMB Small Buffer mode - allows small data 

segments to be transmitted to terminals. 

This mode is used by DECnet in communication 

with terminals, SRV: , and DCN : devices. 



TOPS-20 Version 5 2-54 April 1982 



FUNCTIONAL ORGANIZATION OF JSYS'S 

Device Mode Symbol Explanation 

10 .GSIMG Image mode - sends an "image" (rather than 
converting to Hollerith) of each byte. 
These are 12-bit bytes and are assumed to be 
in Hollerith code. If the device is opened 
with a byte size smaller than 12-bits, each 
byte sent is zero-padded on the left to form 
a 12-bit byte. 

CDR: 

PCDR: .GSNPM Normal mode - allows unit-record input. For 

card readers, this mode converts each 12-bit 
card-column code (Hollerith code) to a 7-bit 
ASCII character and returns the ASCII 
character to the program. 

10 .GSIMG Image mode - returns an "image" (rather than 
converting to ASCII) of the i2-bit card-code 
for each character read. In order to 
receive the full 12 bits, the program must 
use 12-bit bytes. 

Augmented image mode - this is a 16-bit 
version of image mode. The leftmost 4 bits 
are returned by the card reader controller. 
The first bit indicates that the column has 
a Hollerith error (and thus the card should 
be rejected). The next 3 bits contain a 
value ranging from to 7. If the value is 
from 1 to 7, it indicates that a punch 
occurred in that row. If the value is 0, it 
indicates that no punch occurred in columns 
1 - 7. Effectively, a zero value indicates 
that a non-ASCII character was punched. 
This mechanism allows conversion to ASCII 
using a table with only 256 entries as 
opposed to a table with 4096 entries for 
12-bit characters. This mode is available 
on PCDR: devices only and is used by 
specifying mode .GSIMG with a 16-bit 
bytesize . 

DCN: .GSNRM Normal mode - allows byte I/O. This device 

may be opened with 7, 8 or 36-bit bytes. 
However, all transfers are actually done 

with 8-bit bytes, and opening the device 

with an 8-bit bytesize will give the 

greatest efficiency. Recruires DECnet 
software. 

DSK: .GSNRM Normal mode - allows buffered byte, string, 

and paged I/O in 1 to 36-bit bytes. By 
definition, a DSK: device may be opened in 
any I/O mode, however the effect is the same 
as mode 0. 



LPT 



PLPT: .GSNRM Normal mode - allows buffered 
byte and string output. 
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Device Mode Symbol Explanation 

PTY: .GSNRM Normal mode - for a PTY, the "mode" is 

merely used to open the device. The PTY 
will receive data according to the I/O mode 
of the TTY associated with it. 

MTA: 

MT: .GSNPM Normal mode - allows buffered byte and 

string I/O. This is the most common I/O 

mode. 

17 .GSDMP Dump mode - this mode is unbuffered by 
default (it can be set up for 
double-buffering) and is usually used to 
transfer blocks of data from tape to disk or 
disk to tape. For tape, a dump-mode read 
(performed by DUMPI JSYS) performs reads on 
the basis of physical records. If less than 
a physical record is read, the data is 
transferred and an error is returned. A 
subsequent DUMPI will begin reading the tape 
at the start of the next physical record. 

NET: For ARPANET systems only. Allows buffered 

or non-buffered byte and string I/O in 8, 
32, or 36-bit bytes as follows: 

Non-buffered send mode with wait. Waits for 

state of connection to be other than 
"request for connection sent" before the 
OPENF returns. Data is transmitted on every 
JSYS. 

5 Buffered send mode with wait. Waits for 
state of connection to be other than 
"request for connection sent" before the 
OPENF returns. Data is sent a buffer-load 
(8000 bits) at a time. The concept of 
buffering does not apply to input. 

6 Non-buffered send mode with no wait. 

7 Buffered send mode with no wait. Data is 
sent a buffer-load (8000 bits) at a time. 
The concept of buffering does not apply to 
input. 

NUL: .GSNRM Normal mode 

Image mode 
Dump mode 

The NUL device is a pseudo device used to 
"throw away" unwanted output from a program. 
The device may be opened in any mode. 






.GSNRM 


10 


.GSIMG 


17 


.GSDMP 
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Device Mode Symbol Explanation 

SRV: .GSNRM Normal mode - allows byte I/O. This device 

may be opened with 7, 8, or 36-bit bytes. 
However, all transfers are actually done 
with 8-bit bytes, and opening the device 
with an 8-bit bytesize will give the 
greatest efficiency. Requires DECnet 
software. 

TTY: ..GSNRM Normal mode - allows buffered byte and 

string I/O. In this mode, format control 
and simulation and translation of control 
characters are performed by the monitor for 
input (echo) and output. (These services 
can be turned off by setting the appropriate 
bit in the JFN mode word.) Using an 8-bit 
bytesize in this mode implicitly changes the 
mode to .GSIMG (see below) . 

10 ..GSIMG Image mode - allows buffered byte and string 
I/O, but disables format control and 
simulation and translation of control 
characters. On input, if the byte size is 8 
bits, a parity bit (odd) is returned with 
the character. The parity bit is the 
high-order bit. On output, attempting to 
send an 8-bit byte that has incorrect parity 
may cause a device error. However, most 
terminals ignore a user-supplied parity bit. 

This mode can cause some reduction in the 
CPU time charged to a job for doing TTY 
output. The reduction is small, however, 
for TTY input. This is because the average 
process outputs many more characters than it 
inputs (the average ratio is approximately 
20 characters output for each character 
input) . 



2.6 SOFTWARE INTERRUPT SYSTEM 

The monitor calls in this group are used for controlling the software 

interrupt system. Note that if the program has an EPJMP or ERCAL 

after a monitor call that normally causes an interrupt on failure, the 

ERJMP or ERCAL overrides the interrupt. Refer to the TOPS-20 Monitor 

Calls User's Guide for an overview and description of the software 
interrupt system. 



2.6.1 Software Interrupt Channels 

Each interrupt is associated with one of 36 software interrupt 
channels below. The user program can assign channels 0-5 and 23-35 to 
various conditions, such as terminal interrupts, IPCF interrupts, 
ENQ/DEQ interrupts, PTY conditions, and terminal buffers becoming 
empty. The remaining channels are permanently assigned to certain 
error conditions. Any channel may be used for program-initiated 
interrupts (IIC call) . 



2-57 



FUNCTIONAL ORGANIZATION OF JSYS'S 



Table 2-12 
Software Interrupt Channels 



Channel 


Symbol 


Meaning 


0-5 




Assignable by user program 


6 


.ICAOV 


Arithmetic overflow (includes NODIV) 


7 


.ICFOV 


Arithmetic floating point overflow 
(includes FXU) 


8 




Reserved for DEC 


9 


.ICPOV 


Pushdown list (PDL) overflow i 


10 


•ICEOF 


End of file condition 


11 


.ICDAE 


Data error file condition 1 


12 


.ICQTA 


Disk full or quota exceeded when creating 
a new page i 


13-14 




Reserved for DEC 


15 


.ICILI 


Illegal instruction i 


16 


.ICIRD 


Illegal memory read i 


17 


.ICIWR 


Illegal memory write 1 


18 




Reserved for DEC 


19 


.ICIFT 


Inferior process termination or forced 
freeze 


20 


•ICMSE 


System resources exhausted * 


21 




Reserved for DEC 


22 


.ICNXP 


Reference to non-existent page 


23-35 




Assignable by user program 


i These 


channels are pa 


nic channels and cannot be completely 


deactivat 


ed . (Refer to 


Section 2.6.5.) 



2.6.2 Software Interrupt Priority Levels 

Each channel is assigned to one of three priority levels. The 
priority levels are numerically referenced as level 1, 2, or 3 with 
level 1 being the highest level interrupt. Level is not a legal 
priority level. If an interrupt request occurs in a process where the 
level associated with the channel is 0, the system considers the 
process not prepared to handle the interrupt. The process is then 
frozen or terminated according to the setting of SC%FRZ (bit 17) in 
its capabilities word. (Refer to Section 2.7.1.) 
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2.6.3 Software Interrupt Tables 

Before using the software interrupt system, a process must set up the 
following two tables and declare their addresses with the XSIR% or SIR 
calls. 

LEVTAB 

A 3-word table, indexed by priority level minus 1. There are two 
forms of this table. 

In the general form, each word contains the 30-bit address of the 
first word of a two-word block in the process address space. The 
block addressed by word n of LEVTAB is used to store the global 
PC flags and address when an interrupt of level n+1 occurs. 

The PC flags are stored in the first word of the PC block, and 
the PC address is stored in the second. This form of the table 
must be used with the XSIR% and XRIR% monitor calls, and can be 
used in any section. 

The older form of the interrupt level table can be used in any 
single- | section program, and must be used with the SIP and RIR 
calls. This table also contains three words, indexed by the 
priority level minus 1. Each word contains zero in the left 
half, and the 18-bit address of the word in which to store the 
one-word section-relative PC in the right half. 



CHNTAB 



A 36-word table, indexed by channel number. This table also has 
two formats. 

The general format, for use with the XSIR% and XRIR% calls, can 
be used in any section of memory. Each word contains, in bits 
0-5, the priority level (1, 2, or 3) to assign to interrupts 
generated on that channel; and in bits 6-35, the starting 
address of the routine to process interrupts generated on that 
channel . 

In the older format, for use with the SIR and RIR calls by any 
single-section program, the left half of each word contains the 
priority level (1, 2, or 3) for that channel. The right half 
contains the address of the interrupt routine that will handle 
interrupts on that channel . 



2.6.4 Terminating Conditions 

If an interrupt is received on a channel that is activated, but the 
interrupt cannot be initiated because 

1. the interrupt system for the process is not enabled (EIR 
JSYS) and the channel on which the interrupt occurred is a 
panic channel, 

2. the table addresses have not been defined (SIR call), 

3. no priority level has been assigned to the channel (i.e., 
left half of channel's word in CHNTAB is 0), or 

4. the channel has been "reserved" by the superior process 
(refer to the SIPCM call description), 
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then the interrupt is considered a process termination condition. In 
this case the process that was to have received the interrupt is 
halted or frozen according to the setting of SC%FRZ (bit 17) in its 
capabilities word, and a process termination interrupt is sent to its 
superior. The superior process can then execute the RFSTS call to 
determine the status of the inferior process. 



2.6.5 Panic Channels 

Panic channels (refer to Section 2.6.1) cannot be completely 
deactivated by disabling the channel or the entire interrupt system. 
A software interrupt received on a panic channel that has been 
deactivated will be considered a process terminating condition. 
However, panic channels will respond normally to the channel on/off 
and read channel mask monitor calls. 



2.6.6 Terminal Interrupts 

There are 36 (decimal) codes used to specify terminal characters or 
conditions on which interrupts can be initiated. A process can assign 
a character or condition to any one of the program-assignable inter- 
rupt channels with the ATI call. Once the particular code is assigned 
to a channel and the channel is activated (by means of AIC) , 
occurrence of the character or condition corresponding to the code 
causes an interrupt to be generated. The terminal codes, along with 
their associated conditions, are shown in the table below. 



Table 2-13 
Terminal Interrupt Codes 



Terminal 


Symbol Character 


or Condition 


Code 









.TICBK CTFL/@ 


or break 


1 


.TICCA CTRL/A 




2 


.TICCB CTPL/B 




3 


.TICCC CTRL/C 




4 


.TICCD CTPL/D 




5 


.TICCE CTPL/E 




6 


.TICCF CTRL/F 




7 


.TICCG CTPL/G 




8 


.TICCH CTRL/H 




9 


.TICCI CTRL/I 


(tab) 


10 


.TICCJ CTRL/J 


(line feed) 


11 


.TICCK CTRL/K 


(vertical tab) 


12 


.TICCL CTRL/L 


(form feed) 


13 


•TICCM CTRL/M 


(carriage return) 


14 


.TICCN CTRL/N 




15 


.TICCO CTRL/O 




16 


.TICCP CTRL/P 




17 


.TICCQ CTRL/Q 




18 




.TICCR CTRL/R 
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Table 2-13 (Cont.) 
Terminal Interrupt Codes 



Terminal 


Symbol Character or Condition 


Code 




19 


.TICCS CTRL/S 


20 


.TICCT CTRL/T 


21 


.TICCU CTRL/U 


22 


.TICCV CTRL/V 


23 


.TICCW CTRL/W 


24 


.TICCX CTRL/X 


25 


.TICCY CTRL/Y 


26 


.TICCZ CTRL/Z 


27 


.TICES escape (altmode) 


28 


.TICRB delete (rubout) 


29 


.TICSP space 


30 


.TICRF dataset carrier off 


31 


.TICTI typein 


32 


.TICTO typeout 


33-35 


reserved for DEC 



The terminal code ..TICRF (30) is used to generate an interrupt when 
the dataset carrier state changes from on to off. Although any 
process can enable for this interrupt, only the top-level process in 
the job is guaranteed to receive it when the carrier state changes. 
If other processes enable for the interrupt, they can receive the 
interrupt either when the carrier state changes to off or later when 
the job is reattached after the detach caused by the carrier-off 
condition. In general, the occurrence of the change in the dataset 
carrier state is usable only by the top-level process. 

The terminal codes .TICTI (31) and .TICTO (32) are used to generate 
interrupts on receipt of any character instead of a specific 
character. The ..TICTI code generates an interrupt when the 
terminal's input buffer becomes nonempty (i.e., when a character is 
typed and the buffer was empty before the input of the character) . 
The .TICTO code generates an interrupt when the terminal's output 
buffer becomes nonempty. Note that neither one of these codes 
generates an interrupt if the buffer is not empty when the character 
is placed into it. The SIBE and SOBE calls can be used to determine 
if the buffers are empty. 

The frozen or unfrozen state (refer to Section 2.7.3.1) of a process 
determines if the interrupt is initiated immediately. Terminal 
interrupts are effectively deactivated when a process is frozen, 
even though the interrupts are indicated in the process' terminal 
interrupt word (obtained with the RTIW JSYS) . When the process is 
unfrozen, the terminal interrupts are automatically reactivated. 

When an operation is completed that explicitly changes the terminal 
interrupt word for the job (e.g., a process freeze or unfreeze 
operation) , the interrupt word for the job (and for the terminal 
line if the job is attached) is set to the inclusive OR (IOR) of all 
the unfrozen processes in the job. When an interrupt character is 
received, frozen processes are not considered when searching for a 
process to interrupt. 
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The user cannot directly access the actual terminal interrupt word. 
However, by specifying a process identifier of -5 as an argument to 
the RTIW or STIW JSYS's, he can read or change the terminal 
interrupt enable mask. The function of this mask is to allow 
processes to turn off interrupt codes activated by superior 
processes. Normally, the mask is -1, thereby enabling all terminal 
interrupts to be activated. A zero in any position of the mask 
prevents the corresponding terminal interrupt from being active. 
However, the fact that a code has been activated is remembered, and 
the code is activated when the mask is changed with a one in the 
corresponding position. Note that the process must have SC%CTC 
enabled in its capabilities word (refer to Section 2.7.1) to 
activate the terminal code for CTRL/C interrupts. 

The SCTTY monitor call can be used to change the source of terminal 
interrupts for a process. Note that the process must have SC%SCT 
enabled in its capabilities word (refer to Section 2.7.1) to change 
the source of terminal interrupts. 

2.6.6.1 Terminal Interrupt Modes - TOPS-20 handles the receipt of a 
terminal interrupt character in either immediate mode or deferred 
mode. An interrupt character handled in immediate mode causes the 
initiation of a software interrupt immediately upon its receipt, by 
the system (i.e., as soon as the user types it). An interrupt 
character handled in deferred mode is placed in the input stream and 
initiates a software interrupt only when the program attempts to 
read it from the input buffer. In either case, the character is not 
passed to the program. If two occurrences of the same deferred 
interrupt character are received without any intervening character, 
the interrupt has an immediate effect. To detect this situation, 
the system maintains a separate one-character buffer in case the 
input buffer is otherwise full. The system assumes that interrupts 
are to be handled immediately unless the process has declared them 
deferred with the STIW monitor call. 

The purpose of deferred mode is to allow interrupt actions to occur 
in sequence with other actions in the input stream. However, with 
multiple processes, the deferred interrupt occurs when any process 
of the job reads the interrupt character. If this process is the 
one enabled for the interrupt, it will be interrupted before any 
more characters are passed to the program. If the process to be 
interrupted is the top process, then the interrupt occurs before 
more characters are passed to the program, unless another process is 
also reading from the same source (usually an abnormal condition). 
If neither of the above situations applies, then the process doing 
terminal input continues to run and may receive several characters 
before the interrupt can take effect. This is unavoidable since the 
process doing input and the process to be interrupted are logically 
running in parallel. 



2.6.7 Dismissing an Interrupt 

Once the processing of an interrupt is complete, the user's 
interrupt routine returns control to the interrupted process by 
means of the DEBRK call. When the DEBPK call is executed, the 
monitor examines the contents of the return PC word to determine 
where to resume the process. If the PC word has not been changed, 
the process is restored to its state prior to the interrupt. For 
example, if the process was dismissed waiting for I/O to complete, 
it is restored to that state after execution of the DEBRK call. If 
the PC word has been changed, the process resumes execution at the 
new PC location. 
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The process can determine if an interrupt occurred during the 
execution of monitor code or user code by examining the user/exec 
mode bit (bit 5) of the return PC word. If the bit is on, the 
process was executing user code; if the bit is off, the process was 
executing monitor code (i.e., a JSYS) . If the interrupt routine 
changes the return PC during the processing of an interrupt, the 
user-mode bit of the new PC word must be on. Note that the process 
may be executing monitor code but that the address portion of the PC 
is referencing a location in user code. To return to that user code 
location (i.e., to interrupt the execution of a monitor call), the 
process must turn on the user-mode bit. 

The monitor calls for controlling the software interrupt system are: 

SIR Sets the interrupt table addresses for a 

single-section process 
XSIR% Sets the interrupt table addresses for a 

multiple-section process 
RIR Reads the interrupt table addresses for a 

single-section program 
XRIR% Reads the interrupt table addresses for a 

multiple-section program 
EIR Enables the interrupt system 
DIR Disables the interrupt system 
CIS Clears the interrupt system 
SKPIR Skips if the interrupt system is enabled 
AIC Activates interrupt channels 
IIC Initiates interrupts on specific channels in a 

process 
DIC Deactivates interrupt channels 
RCM Reads activated channel word mask 
PWM Reads waiting channel word mask 
SIRCM Sets inferior reserved channel mask 
RIRCM Reads inferior reserved channel mask 
DEBRK Dismisses current interrupt 
ATI Assigns terminal code to channel 
DTI Deassigns terminal code 
STIW Sets terminal interrupt word 
PTIW Reads terminal interrupt word 
GTRPW Returns trap words 
XGTPW% Returns page-fail words 
SCTTY Changes source of terminal interrupts 



2.7 PROCESS CAPABILITIES 

The TOPS-20 system allows capabilities, such as the ability to 
examine the monitor and to enable for CTRL/C interrupts, to be given 
to certain processes. Each capability is separately protected and 
activated. The capabilities are assigned on a per-process basis, 
and their status is kept in the process 1 PSB. 

The number of capabilities is limited to 36, and two words are used 
to store the status. For each capability, there is a bit in the 
first word that is set if the capability is available to the 
process. If the corresponding bit in the other word is also set, 
the capability is currently enabled. This allows the user to 
protect himself against accidental use without, actually giving up 
the capability. 
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Inferior processes are created by superior processes (by means of 
the CFORK monitor call) with either no special capabilities or the 
capabilities of the creating process. Most capabilities relate to 
system functions and may be passed from superior to inferior process 
only if the superior itself has the capability. Some capabilities 
relate the inferior to the superior process, and may be given to an 
inferior whether or not available in the superior. 



2.7.1 Assigned Capabilities 

The following table lists the capabilities available for processes 
and jobs. 



Table 2-14 
Process/Job Capabilities 



Bit 


Symbol 


Meaning 






BO-8 Job Capabilities 





SC%CTC 


Process can enable for CTPL/C software 
interrupts . 


1 


SC%GTB 


Process can examine monitor tables with the 
GETAB call. 

Note that the possession of this capability 
allows the process to do a GETAB. The 
capability need not be enabled. 


3 


SC%LOG 


Process can execute protected log functions (by 
means of the LGOUT JSYS) . 

Note that the possession of this capability 
allows the process to do a LGOUT. The 
capability need not be enabled. 


6 


SC%SCT 


Process can change the source of terminal 
interrupts for other processes. 

B9-17 Capabilities that can be given to an 
inferior whether or not the superior itself has 
them. Of these, SC%FPZ (B17) cannot be changed 
by a process for itself. 


9 


SC%SUP 


Process can manipulate its superior process. 


17 


SC%FPZ 


Unprocessed software interrupts can cause the 
process to be frozen instead of terminated. 

B18-35 User capabilities 


18 


SC%WHL 


User has wheel privileges. 


19 


SC%OPR 


User has operator privileges. 


20 


SC%CNF 


User has confidential information access. 
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Table 2-14 (Cont.) 
Process/Job Capabilities 



Bit 


Symbol 


Meaning 


21 


SC%MNT 


User 


has 


maintenance privileges. 




22 


SC%IPC 


User 


has 


IPCF privileges. 




23 


SC%ENQ 


User 


has 


ENQ/DEQ privileges. 




24 


SC%NWZ 


User 


has 


ARPANET wizard privileges. 




25 


SC%NAS 


User 


has 


absolute ARPANET socket privi 


leges. 


26 


SC%DNA 


User 


has 


access to DECNET 




27 


SC%ANA 


User 


has 


access to ARPANET 





User capabilities are originally established when the user's logged-in 
directory is created. (Refer to the CRDIR monitor call.) 

The capability word can be read with the PPCAP monitor call. 
Capabilities can be enabled with the EPCAP monitor call. 



2.7.2 Access Control 

It is often necessary for an installation to have more control over 
system resources than that offered by the process capability word. 
The following JSYS ' s allow each installation to write its own 
access-control program: 



1. 


GETOK% 


2. 


GIVOK% 


3. 


RCVOK% 


4. 


SMON 


5. 


TMON 



The access-control facility works as follows: 



The installation writes its own access-control program. This 
program uses the SMON JSYS (privileged) to (lj enable or 
disable access checking for a variety of system resources and 
(2) allow or disallow access by default for those resources 
that are not explicitly checked by the access-control 
program. 

The access-control program initializes itself and then issues 
the .SFSOK function of the SMON JSYS (privileged) to enable 
various types of access checking and to define itself as the 
access-control program. 
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3. The access-control program issues a PCVOK% JSYS (privileged). 
As the request queue is empty until a GETOK% request has been 
made, the FCVOK% JSYS causes the access-control program to 
block . 

4. A system program or the monitor issues a GETOK% JSYS, causing 
an access request block to be appended to the GETOK% request 
queue (maintained by the monitor). The system program or 
monitor then blocks. 

5. The monitor wakes up the access-control program and the 
blocked PCVOK% JSYS completes execution, retrieving the 
access request block from the GETOK% request queue. This 
block contains information supplied by the GETOK% call, plus 
certain job parameters. 

6. The access-control program determines whether to allow or 
deny the request and issues the GIVOK% JSYS (privileged) with 
the appropriate response for this request. The 
access-control program now issues another PCVOK% JSYS, which 
blocks or completes, depending on whether or not any 
additional requests are in the queue. 

7. The system program or the monitor unblocks and gets a +1 
return from the original GFTOK% JSYS if the request has been 
granted, or gets an illegal instruction trap if the request 
has been denied. 

Note the following characteristics of the access-control facility: 

1. The GETOK% JSYS is imbedded in the code that is being 
protected against unauthorized use. For example, a 
DEC-supplied GETOK% function allows access-control of the 
CRJOB JSYS; thus the TOPS-20 code that implements CRJOB will 
itself execute a GETOK% JSYS. An installation can also place 
GETOK% JSYS's in appropriate places in other software to 
provide additional access control. 

However, this entire process is invisible to the ordinary 
user program. The only change such a program would encounter 
in an access-controlled environment would be the illegal 
instruction trap generated if the program attempted to use a 
protected resource that it was not entitled to use. 

2. JSYS's performed by the access-control program or job will 
not invoke access control. 

3. After a system has been brought up, the first fork to execute 
the .SFSOK function of the SMON JSYS defines itself as the 
access-control fork. Any other fork that subsequently tries 
to issue a RCVOK% JSYS, a GIVOK% JSYS, or an SMON JSYS with 
function .SFSOK will receive an error. 

4. The access-control facility has two timers associated with 
it: 

1.) The time period between the execution of a GETOK% JSYS 
and its corresponding GIVOK% JSYS is measured. If the period 
exceeds a maximum, a BUGINF is generated on the CTY. 
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2.) The time period between the GETOK entry into the queue 
and the RCVOK% being executed is measured. If the period 
exceeds a maximum, a BUGCHK is generated on the CTY, all 
defaults are reestablished, the GETOK% request queue is 
flushed (the defaults are in effect for those requests also) , 
and the monitor will no longer place GETOK% requests in the 
GETOK% aueue. 



2.7.3 Processes and Scheduling 

These monitor calls deal with establishing and interrogating the 
process structure of a job. Refer to the TOPS-20 Monitor Calls User's 
Guide for an overview and description of the process structure. 



2.7.3.1 Process Freezing - A superior process can cause one or all of 
its inferior processes to be frozen. A frozen process is one whose 
execution is suspended (as soon as it is stoppable from the system's 
point of view) in such a way that it can be continued at the point it 
was suspended. A process can be frozen directly or indirectly. A 
process is directly frozen when its superior makes an explicit request 
to freeze it. A process is indirectly frozen when its superior is 
frozen. When a process is directly frozen, all of its inferior 
processes are indirectly frozen. Therefore, a process can be both 
directly frozen by its superior process and indirectly frozen if its 
superior process is subsequently frozen. 

The explicit unfreezing of a process clears both its direct freeze and 
the indirect freeze on all its inferior processes unless an inferior 
process has a direct freeze. The indirect unfreezing of a process 
clears only the freeze on that process. This means that an explicit 
freeze of a process prevents the running of any of its inferior 
processes, and an explicit unfreezing of a process automatically 
resumes its inferiors. 

The FFORK and RFORK monitor calls are used to freeze and unfreeze 
processes, respectively. An argument of -4 to these calls directly 
freezes or resumes all immediately inferior processes, and any 
processes below the immediately inferior ones are indirectly frozen or 
resumed. (The freeze and unfreeze operations are never legal on any 
process that is not inferior to the one executing the monitor call.) 

The frozen or unfrozen state of a process can only be changed 
directly. Thus, monitor calls like SFORK and HFOPK change other 
states of a process but do not affect the frozen state. If the 
process is frozen and a call is executed that changes one of its 
states, the process remains frozen and does not begin operating in the 
changed state until it is resumed. For example, a program can change 
a frozen process' PC with the SFORK call, but the process will not 
begin running at the new PC until it is unfrozen. Similarly, the 
HFORK call can be executed on a frozen process, but the process will 
not be in the halted state until it. is unfrozen. The changed status 
is always reflected in the information returned by the RFSTS call. In 
the first example above, RFSTS would return the changed PC, and in the 
second, it would return the halted code in the status word. 
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The monitor calls associated with capabilities and processes are: 

RPCAP Returns process capabilities word 

EPCAP Enables process capabilities word 

RESET Resets and initializes current process 

CFORK Creates inferior process 

SFORK Starts a process in section zero 

XSFRK% Starts a process in a non-zero section 

HFORK Halts an inferior process 

HALTF Halts a process 

DISMS Dismisses process for specified amount of time 

WAIT Dismisses process until interrupt occurs 

WFORK Waits for process to terminate 

KFORK Kills one or more processes 

FFORK Freezes one or more processes 

RFORK Resumes one or more processes 

TFORK Sets and removes monitor call intercepts 

RTFRK Returns the handle of the process suspended because of 

a monitor call intercept 

UTFRK Resumes a process suspended because of a monitor call 

intercept 

RFSTS Returns process' status 

SFACS Sets process 1 accumulators 

RFACS Returns process 1 accumulators 

PRARG Sets or returns process argument block 

RFRKH Releases process handles 

GFRKS Gets current process structure 

GFRKH Gets process handle 

SPLFK Splices a process structure 

RMAP Obtains a handle on a page in a process 

SPACS Sets accessibility of page 

RPACS Returns accessibility of page 

RSMAP% Returns information about the mapping of one section of 

a process 

RWSET Releases working set 

ADBRK Controls address breaks 



2.7.3.2 Execute-Only Files and Execute-Only Processes - The basic 

definition of an execute-only file is one that cannot be copied, read, 

or manipulated in the usual manner, but can be run as a program. An 
execute-only file has the following characteristics: 



1. The file must be protected with execute access allowed, 
with read access not allowed. 



but 



2. The file cannot be read or written using any of the 
file-oriented monitor calls (SIN, SOUT, BIN, BOUT, PMAP, 
etc. ) . 

3. The file can be mapped into a process (using GET), but only 
in its entirety and only into a virgin process. A process so 
created is called an execute-only process. 



NOTE 

A virgin process is one that has just been created 
(using CFORK). Furthermore, if a process is virgin, 
no operations have been performed on the process. 
This means no changes have been made to its address 
space, PC, AC's, interrupt system, or traps, and the 
process has not been mapped to a file or another 
address space. 
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4. Only disk-resident files can be considered execute-only. 

5. A process with WHEEL or OPERATOR capabilities enabled can 
gain read access to any file and can thus circumvent the 
execute-only features of an execute-only file. 

An execute-only process has the following characteristics: 

1. An execute-only process can be started only at its entry 
vector . 

2. A process that is created by an execute-only process and 
shares the same address space becomes execute-only itself. 

3. No other process can read from an execute-only process 1 
address space or accumulators. 

4. No other process can change any part of an execute-only 
process' context in such a way as to cause the execute-only 
process to unintentionally reveal any part of its address 
space. 

5. An execute-only process can not be prevented from mapping 
pages of its own address space into an inferior process. It 
is the programmer's responsibility to avoid revealing an 
execute-only process through its inferior forks. 

6. No JSYS explicitly indicates that a given process is 
execute-only. However, the RFACS JSYS will always fail for 
an execute-only process and can be used to determine this 
information, if it is required. 

A program is execute-only for particular users based on its file 
protection. If a user tries to run a file and can't read it, but does 
have execute access, a process is created as usual. The file is 
mapped into this virgin process, circumventing the read protection on 
the file. This process is then an execute-only process. 

Users may select a file to be execute-only by allowing execute but not 
read access to the file. This can be done by setting the protection 
field for the desired class of users (owner, group, or world) to 
FP%EX+FP%DIR, or 12 octal. For example, to make a file execute-only 
for everybody except the owner of the file, the user would set the 
protection to 771212 octal. 

The following JSYS's do not work for execute-only programs: 

1. ADBRK - referring to an execute-only process 

2. GET - referring to an execute-only process 

3. PMAP - with either source or destination an execute-only 
process 

4. SCVEC - referring to an execute-only process 

5. SDVEC - referring to an execute-only process 

6. SEVEC - referring to an execute-only process 

7. SMAP% - with either source or destination an execute-only 
process 
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8. SPACS - referring to an execute-only process 

9. XGVEC% - referring to an execute-only process 

10. XSVEC% - referring to an execute-only process 

The START command cannot be used with a start address argument for an 
execute-only process. A program that is execute-only must be written 
to protect itself. The program should not map itself out to inferior 
processes unless the entire address space is mapped. The program 
should not do a GET and execute programs in its address space over 
which it has no control. 

Some programs cannot be made execute-only. Some major examples are: 

1. Any object-time system, such as LIBOL or FOPOTS . They must 
be merged into the address space and thus violate the 
restriction of reading an execute-only file into a virgin 
address space. Note that an execute-only process can merge 
in an object-time system, however. 

2. The TOPS-10 compatibility package (PA1050). This has the 
same restriction that object-time systems have. 

3. Any program that uses the TOPS-10 PUN or GETSEG UUO ' s . These 
UUO's require mapping into a non-virgin address space. 

4. Any program that needs to be started at any location other 
than its entry vector (STAPT or PEENTEP address) . 



2.8 SAVE FILES 

A save file is a method of storing an executable memory image on disk. 
TOPS-20 handles two formats of save files: nonsharable (primarily 
intended for compatibility with TOPS-10) and sharable. 

Save files use data compression to reduce the size of the on-disk 
copy. Non-sharable save files use word-oriented compression: memory 
words containing zero are not stored in the disk file. Sharable save 
files use page-oriented compression: memory pages in which all words 
contain zero are not stored in the disk file. 

Shareable save files are generated with the TOPS-20 SAVE command or 
the SSAVE JSYS. Non-sharable save files are generated with the 
TOPS-20 CSAVE command or the SAVF JSYS. The formats of the two types 
of save files are discussed be]ow. 



2.8.1 Format for Nonsharable Save Files 

The format of a nonsharable save file is as follows: 

IOWD length, address at which to put "length" data words 
"length" data words 



TOPS-20 Version 5 2-7C April 1982 



FUNCTIONAL ORGANIZATION OF JSYS ' S 

IOWD length, address at which to put "length" data words 
"length" data words 



XWD length of entry vector, pointer to first word of 
entry vector 



2.8.2 Format of Sharable Save Files 

A sharable save file is divided into two main areas: the directory 
area contains information about the structure of the file, and the 
data area contains the data of the file. 

The following diagram illustrates the general format of a sharable 
save file: 

Directory ======================== 

Area: ! Directory Section ! 

i i 

i i 



! Entry Vector Section ! 

! Program Data Vector ! 

! Section ! 

! Terminating Section ! 

Data Area: ! Data Section ! 

i i 

i j 

i i 

i i 

i i 

; i 

i i 

i i 



The directory area of the save file has four sections: the directory 
section, the entry vector section, the program data vector section, 
and the terminating section. The directory area may be from 1 to 3 
pages long, depending on the access-characteristics of the pages in 
the data area of the save file. Although SSAVF% creates a directory 
area that is only one page long, there is no limit to the size of a 
directory area created with the SAVE% monitor call. 

Each of the four sections in the directory area begins with a word 
containing its identifier code in the left half and its length in the 
right half. Each section is described in the paragraphs below. 

The directory section is the first of the three sections and describes 
groups of contiguous pages that have identical access. The length of 
this section varies according to the number of groups that can be 
generated from the data portion of the save file. The more data pages 
that can be combined into a single group, the fewer groups required, 
and the smaller the directory section. 
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The format of the directory section is as follows 



8 9 



17 1! 



35 



Identifier code 
1776 



! Number of words 
! (including this word) 
! in directory section 



Access ! Page number in file, or if group 
bits ! of pages is all zero 



Repeat 
count 



Page number in the process 



additional word pairs (as necessary) 
to describe each group of pages 
in the process address space 



Access bits ! 
Repeat count ! 



Page number in the file 
Page number in the process 



The access bits are determined from the access bits specified by the 
user on the SSAVE monitor call. The bits currently defined in the 
directory section are: 

Bl The process pages in this group are sharable 

B2 The process pages in this group are writable 

The remaining access bits in the directory section are zero. 

The repeat count is the number (minus 1) of consecutive pages in the 
group described, by the word pair. Pages are considered to be in a 
group when the following three conditions are met: 

1. The pages are contiguous. 

2. The pages have the same access. 

3. The pages either are all zero or are all existent and 
readable . 

A page is considered to be all zero if it is nonexistent or is not 
readable. A page containing all zeros is considered to be existent. 
A group of all zero pages is indicated by a file page number of 0. 

The word pairs are repeated for each group of pages in the address 
space. 
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The entry vector section follows the directory section, and points to 
the entry vector. The format of the entry vector section is as 
follows: 



17 II 



35 



Identifier code 
1775 



! Number of words 
! (including this word) 
! in entry vector section 



Number of words in entry vector 
Address of entry vector 



This section contains the address of the entry vector. 
Section 2.8.3 for a description of the entry vector. 



Refer to 



The program data vector section follows the entry vector section. The 

program data vector section contains the addresses at which the 

program data vectors begin (PDVA's). This section is optional, and 
only appears if the program declares some program data vectors. 

The format of the program data vector section is as follows: 



17 1! 



35 



Identifier code 
1774 



Number of words 

(including this word) 

in data vector section 



Add 


ress 


of 


data 


vector 


1 


Add 


ress 


of 


data 


vector 


2 



Address of data vector n 



!=======================================================! 

i 

============ i 



The terminating section follows the program data vector section. Its 
format is as follows: 



Identifier code 
1777 



The remaining words in the last page of the save file are filled with 
zeros and are ignored by the monitor. 
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2.8.3 Entry Vector 

The entry vector is a block of data that describes entry conditions to 
be used when the program in the process is executed. The first word 
of the entry vector contains the program start instruction, the second 
word contains the program reenter instruction, and the third word 
contains the program version number. (The version number format is: 
B0-B2 containing the group who last modified the program, B3-B11 
containing major version number, B12-B17 containing minor version 
number, and B18-B35 containing edit number.) Subsequent words in the 
entry vector can contain data applicable to the particular entry 
(refer to the GCVEC and GDVEC monitor calls) . 

Typically, the entry vector looks like this: 

JRST btart-addr 
JRST reenter-addr 
version number 



Each process has an entry vector word in its process storage block. 
The format of the entry vector word is: 

LH: length of the entry vector (1-777) 

RH : address of the first word of the entry vector. 

The data for this word is obtained from the entry vector in the save 
file when a GET monitor call is executed for the file. 

Note that if the left half of the entry vector (usually the length) is 
254000 (octal), then there is no real entry vector. The program start 
address is in the right half of location 120, the reenter address is 
in the right half of location 124, and the program version is in 
location 137. This format is not recommended, but is maintained for 
compatability with older monitors. 

The following monitor calls are used in conjunction with save files: 

GET Obtains a saved file 

SAVE Saves a process as nonsharable 

SSAVE Saves a process as sharable 

SEVEC Sets the entry vector for a single-section program 

XSVEC% Sets the entry vector for a multiple-section program 

GEVEC Gets process entry vector of a single-section program 

XGVEC% Gets process entry vector for a multiple-section 

program 

SFRKV Starts process using its entry vector 

XSFRK% Starts a process using a user-supplied, global PC 

SCVEC Sets compatibility package entry vector 

GCVEC Gets compatibility package entry vector 

SDVEC Sets RMS entry vector 

GDVEC Gets RMS entry vector 
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2.8.4 Program Data Vector 

The program data vector (PDV) is a block of data that LINK writes into 
memory when loading and linking a program. The PDV resides in memory 
as a part of the program, and starts at a program data vector address 
(PDVA) . User programs can use this data. Although TOPS-20 currently 
does not use the data in the PDV, words 13, 14, and 15 of the PDV are 
provided for possible future system use. 

The format of the program data vector is as follows: 

Word Symbol Meaning 

. PVCNT Length of the PDV (including this word) . 

1 . PVNAM Name of the program for which this data 

vector exists. The name is word-aligned 
ASCII, which means that the characters in the 
name are represented by seven-bit bytes, and 
that the first byte in each word begins with 
bit zero. 

2 .PVSTR Program starting address. 

3 .PVREE Program reenter address. 

4 .PVVER Program version number. 

5 .PVMEM Address of a block of memory that contains 

data describing the program memory (a memory 
map). See the LINK manual, Appendix G, for a 
description of this block. 

6 .PVSYM Address of the program symbol table. 

7 .PVCTM Time at which the program was compiled. 

10 .PVCVR Version number of the compiler. 

11 .PVLTM Time at which the program was loaded. 

12 .PVLVR Version number of LINK. 

13 .PVMON Address of a monitor data block. (Not 

currently used . ) 

14 .PVPRG Address of a program data block. (Not 

currently used . ) 

15 .PVCST Address of a. customer-defined data block. 

The PDVOP% monitor call manipulates PDV's. When loading a program 
into memory, LINK executes a PDVOP% call to give the monitor the 
addresses of the PDV's for that program. The PDVA ' s are the only data 
regarding PDV's that the monitor keeps in its data base. 

Once the monitor knows the PDVA ' s for a program, other programs and 
other processes can use PDVOP% to obtain those PDVA ' s from the 
monitor. An inquiring program or process must use the PDVA (and 
another PDVOP% call) to obtain the data in the PDV. 

The PDVOP% call also allows you to add PDVA ' s to, or delete PDVA ' s 
from, the monitor's data base. Refer to Chapter 3 for a complete 
description of PDVOP%. 



2.9 INPUT/OUTPUT CONVERSION 

The monitor calls in this group perform input/output conversion. 

Calls are available to convert in both directions between ASCII text 

(in core or in a file) and integer numbers, floating point numbers, 

and TOPS-20 internal dates and times. 
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2„9.1 Floating Output Format Control 



2.9.1.1 Free Format - The most common format control used with the 
FLOUT JSYS is free format. This is specified by setting B18-23 
(FL%FST) of the format control word to 0. (Refer to Section 2.9.1.2.) 
Normally, the entire format control word is set to 0; however, 
certain fields may be specified to force a particular output. 

Most numbers greater than or equal to 10~-4 but less than 10~6 (with 
some exceptions) are output in a typical FORTRAN F format. If the 
number is an exact integer, it is output with no terminating decimal 
point unless B6(FL%PNT) is on. If the number is a fraction, it is 
output as .xxxx with no leading O's. Nonsignificant trailing zeros in 
the fraction are never output. A maximum of seven digits is output if 
the second field (FL%SND) is not specified. The sign of the number is 
output only if negative. 

If the number is outside the range above, it is output in a typical 
FORTRAN E format (with some exceptions) . The exponent is output as 
Esxx, where s is the sign output only on negative exponents and xx are 
the digits of the exponent. The above exceptions about outputting the 
decimal point and suppressing trailing, nonsignificant zeros apply. 

Another free format similar to that above is invoked by specifying a 
nonzero value for B13-17 (FL%RND) of the format control word. The 
value in this field specifies the place at which rounding should 
occur. If this value is 7, the output is the same as if the value 
were as above. If this value is less than 7, rounding occurs at the 
specified place, but the output will be as above with a maximum of 7 
digits (e.g., 12360 with a rounding specification of 3 will output as 
12400). If this value is greater than 7, rounding occurs at the 
specified position, but more than 7 digits are output. In this case, 
digits are output until either the rounding specification number is 
reached or until trailing, nonsignificant zeros are reached. 



2.9.1.2 General Format Control - The format control word specifies 
the format for floating point output when free format is not desired. 
The control word indicates the desired output for the three fields of 
the number, plus additional control for items such as rounding. The 
first field of the number is up to the decimal point. The second 
field is from the decimal point to the exponent. The third field is 
the exponent. 
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The format control word is as follows: 



Table 2-15 
Floating-Point Format Control 



Bit 


Symbol 


Meaning 


0-1 


FL%SGN 


Sign control for first field. The first 
character position is always used for the minus 
for negative numbers. For positive numbers, the 
first character position is defined according to 
the values below: 

Value Symbol Meaning 

.FLDIG First character is digit. 

1 . FLSPC First character is space. 

2 .FLPLS First character is plus sign. 

3 .FLSPA First character is space. 


2-3 


FL%JUS 


Justification control for first field. 
Value Symbol Meaning 

.FLLSP Right justify number using 

leading spaces. 

1 .FLLZR Right justify number using 

leading 0's. 

2 .FLLAS Fight justify number using 

leading asterisks. 

3 .FLTSP Left justify number up to 

decimal point using trailing 
spaces after third field. 


4 


FL%ONE 


Output at least one digit (0 if necessary) in 
first field. 


5 


FL%DOL 


Prefix the number with a dollar sign ($). 


6 


FL%PNT 


Output a decimal point. 


7-8 


FL%EXP 


Third (exponent) field control. 
Value Symbol Meaning 

. FLEXN No exponent field. 

1 .FLEXE Output E as first character of 

exponent field. 

2 .FLEXD Output D as first character of 

exponent field. 

3 .FLEXM Output *10~ as first 

characters of exponent field. 
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Table 2-15 (Cont.) 
Floating-Point Format Control 



Bit Symbol 



Meaning 



9-10 



11 

13-17 

18-23 

24-29 
30-35 



FL%ESG 



FL%OVL 

FL%RND 

FL%FST 

FL%SND 
FL%THD 



Value 


Symbol 





.FLDGE 


1 


.FLPLE 


2 


.FLSPE 


3 


.FLDGT 



Exponent sign control. The first character 
position is alv/ays used for the minus for 
negative exponents. For positive exponents, the 
first character position is defined according to 
the values below: 



Meaning 

First character after exponent 

prefix is digit. 

First character after prefix 

is plus sign. 

First character after prefix 

is space. 

First character after exponent 

prefix is digit. 



Use free format on overflow of the first field 
and expand exponent on overflow of the third 
field. If this bit is not set, no additional 
output occurs on column overflow. 

Digit position at which rounding will occur. If 
field is 0, rounding occurs at the 12th digit. 
If field is 37, no rounding occurs. 

Number of characters in first field, including a 
dollar sign ($) if FL%DOL is set. (refer to 
FL%JUS) . 

Number of characters in second field. 

Number of characters in third field. 



As an example, to output a number in the format xx.yy, the following 
bits should be set in AC3 of the FLOUT monitor call. 

B4(FL%ONE) output at least one digit in the first field 

B6(FL%PNT) output a decimal point 

B13-B17 (FL%RND) do not round the number 

B22 output a maximum of two digits in the first field 

B28 output a maximum of two digits in the second field 

Examples of numbers output in this format are: 

43.86 4.24 0.43 
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2.9.2 Date And Time Conversion Monitor Calls 

TOPS-20 internal date and time is maintained in a 36-bit word and is 
based on Greenwich Mean Time. The date is in the left, half and is the 
number of days since November 17, 1858; the time is in the right half 
and is represented as a fraction of a day. This allows the 36-bit 
value to be in units of days with a binary point between the left and 
right halves. The resolution is approximately one-third of a second; 
that is, the least significant bit represents approximately one-third 
of a second. The date changes at the transition from 11:59:59 PM to 
12:00:00 midnight. 

For conversions between local and internal date and time, the time 
zone in which the installation is located is normally used, with 
daylight saving applied from 4AM on the next to last Sunday in April 
to 3:59:59AM on the next to last Sunday in October. 

Two monitor calls in this group, IDTIM and ODTIM, convert date and 
time between text strings (in core or in a file) and internal format. 
These should satisfy most users. However, there are four more calls, 
which are subsets of IDTIM and ODTIM. The calls ODTNC , IDTNC, ODCNV, 
and IDCNV make available separately the conversion between internal 
format date and time and separate numbers for local year, month, and 
day, and the conversion between those numbers and text strings. They 
also provide additional options, which give the caller more control 
over the conversion performed than IDTIM and ODTIM. 

Time zones occur in the calling sequences of the latter four JSYS's. 
A time zone is represented internally as a number between -12 and 12 
decimal, representing the number of hours west of Greenwich. For 
example, EST is zone 5. Zones -12 and 12 represent the same time but 
different days because the zones are on opposite sides of the 
international date line. 

The following are examples of valid dates and times: 

6-FEB-76 
FEB-6-76 
FEB 6 76 
FEB 6, 1976 
6 FEB 76 
6/2/1976 
2/6/76 

Below are examples of valid times: 

1:12:13 

1234 

16:30 (4:30PM) 

1630 

1234:56 

1: 56AM 

1:56-EST 

1200NOON 

12:00:00AM (midnight) 

11:59:59AM-EST (late morning) 

12:00:01AM (early morning) 

"AM" or "PM" can follow a time specification that is not greater than 
12:59:59. "NOON" or "MIDNIGHT" can follow 12:00:00. 
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Any time specification can be followed by a clash and a time zone. 
Table 2-16 lists the time zones defined within TOPS-20, their 
abbreviations, and the left half of the word generated or accepted by 
the calls that read, write, or convert dates and times. The right 
half of the word ordinarily contains the time expressed as seconds 
after midnight. 

Table 2-16 
Time Zones 



Zone Name 


Abbreviation 


Left half 


GREENWICH DAYLIGHT TIME 


GDT 


700000 


GREENWICH MEAN TIME 


GMT 


500000 


GREENWICH STANDARD TIME 


GST 


500000 


ATLANTIC DAYLIGHT TIME 


ADT 


700004 


ATLANTIC STANDARD TIME 


AST 


500004 


EASTERN DAYLIGHT TIME 


EDT 


700005 


EASTERN STANDARD TIME 


EST 


500005 


CENTRAL DAYLIGHT TIME 


CDT 


700006 


CENTRAL STANDARD TIME 


CST 


500006 


MOUNTAIN DAYLIGHT TIME 


MDT 


700007 


MOUNTAIN STANDARD TIME 


MST 


500007 


PACIFIC DAYLIGHT TIME 


PDT 


700010 


PACIFIC STANDARD TIME 


PST 


500010 


YUKON DAYLIGHT TIME 


YDT 


700011 


YUKON STANDARD TIME 


YST 


500011 


ALASKA-HAWAII DAYLIGHT TIME 


HDT 


700012 


ALASKA-HAWAII STANDARD TIME 


HST 


500012 


BERING DAYLIGHT TIME 


BDT 


700013 


BERING STANDARD TIME 


BST 


500013 


LOCAL DAYLIGHT TIME 


DAYLIGHT 


600000 



All strings (e.g., months, time zones, AM-PM-NOON-MIDNIGHT) can be 
represented by any nonambiguous abbreviation (e.g., D-DECEMBER, M- 
MIDNIGHT) . 

Spaces are ignored before and between fields whenever they do not 
terminate the input string. This means spaces are not allowed before 
colons, AM, PM, NOON, and MIDNIGHT, the dash before the time zone, or 
the time zone. A tab is also allowed between the date and time. 



The input string can be terminated by any nonalphanumer ic character. 
Monitor calls relating to date and time are as follows: 



IDTIM 
ODTIM 

IDTNC 

ODTNC 
IDCNV 

ODCNV 

GTAD 



Inputs date and time, converting to internal format 

Outputs date and time, converting from internal format 

to text 

Inputs date and time without converting to internal 

format 

Outputs date and time in internal format 

Converts from day, month, year to internal date and 

time 

Converts from internal date and time to day, month, 

year 

Gets current date and time in internal format 
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2.10 ARCHIVE/VIRTUAL DISK SYSTEM 

The following section defines terms that are used in the description 
of the archive/virtual disk system: 



Virtual disk 



Archived file 



Offline/online 



Invisible/visible 



A storage technique in which the contents of 
some files reside on disk, while the contents 
of other files may reside on tape. When a 
file is "migrated" to tape, a copy of its FDB 
is left on disk and the file is deleted from 
disk. Note that the term "migration" applies 
only to files transferred to tape by the 
virtual disk system. 

A file of unchanging data stored on magnetic 
tape. Although copies of the file may exist 
on disk, the original is stored on magnetic 
tape. When a file gains archive status, it 
can no longer be changed. If a writeable 
copy is desired, the COPY command must be 
used. 

When a file is archived, the file contents 
are usually deleted from disk, leaving only 
the FDB on disk. However, it is possible to 
override the deletion process. 

A file is said to be offline if the file has 
been moved to tape by either the virtual disk 
system or the archive system. A file is said 
to be online if the original or a copy of it 
is on disk. A file may be offline, online, 
or both. A file that is offline and not 
online will have only its FDB stored on disk. 
In the last case, the FDB will contain 
pointers to the saveset and tape file number. 
This provides a link between the FDB on disk 
and the file on tape. 

An invisible file is one that does not appear 
in a simple DIRECTORY listing, and is not 
accessable to programs (unless the GTJFN 
specifically sets bit G1%IIN) and EXEC 
commands. A visible file appears in a 
DIRECTORY listing and is accessable to 
programs and EXEC commands. 

The concept of an invisible file is primarily 
designed to make offline-only files 

However, the 

a file may be 

the file is 

not archived, 



transparent to the user, 
invisible/visible status of 
changed regardless of whether 
online, offline, archived, 
migrated, or not migrated. 



The virtual disk system is designed to conserve disk space by moving 
selected files from disk to tape. Files are marked for migration to 
tape by the REAPER program. At the option of the system 



administrator , 
categories 



REAPER may mark files in any of the following three 
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1. Files that have not been referenced within a specified period 
of time. 



2. 



3. 



Online copies of migrated or archived files that 
been referenced within a specified period of time. 



have not 



Files in a directory that is over permanent disk quota. If 
the directory contains a file named MIGRATION. ORDER, then 
REAPER uses that file as an order list for marking files. 
Otherwise REAPER follows the order given in the REAPER 
command list. Two REAPER passes are made with the first pass 
using the order specified in MIGRATION. ORDER or the REAPER 
command string. If the first pass fails to bring the 
directory under quota, the second pass will consider any file 
in the directory for migration. 

The actual migration of disk files to tape is performed by a special 
DUMPER run. The actual run will occur periodically, with the length 
of the period determined by the system administrator. 

File archiving is designed to write unalterable "permanent" copies of 
disk files on tape. The user voluntarily marks a file for archiving, 
and the next archive/virtual disk DUMPER run will archive the file. 

For added security two tape copies of each archived or migrated file 
are made. 

The following JSYS ' s are used to implement the archive/virtual disk 
system: 

ARCF 

CRDIR 

DELDF 

DELFN 

GTJFN 

GNJFN 

JFNS 

OPENF 

RFTAD 

SETJB 

SFTAD 

SMON 

TMON 



2.11 PRIVILEGED MONITOR CALLS 



The following monitor calls are privileged and require the process to 
have WHEEL or OPERATOR capability enabled. The JSYS's marked with an 
asterisk ("*") require privileges for specific functions only. 



ACCES* 

ALLOC 

ARCF* 

ASNSQ 

ATACH* 

BOOT 

CRDIR* 

CRJOB* 

DELDF* 

DELF* 

DIAG 

DSKAS 



Accesses a directory 

Allocates a device to a particular job 

Performs archive/vir tual-disk operations 

Assigns ARPANET special message queue 

Attaches job to new controlling terminal 

Performs functions required for loading front-end 

software 

Creates or modifies a directory 

Creates a new job 

Expunges deleted files 

Deletes files 

Reserves and releases hardware channels 

Assigns specific disk addresses 
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DSKOP 

EFACT 

ENQ* 

ENQC* 

FLHST 

GACCT* 

GIVOK% 

GTDIR* 

HALTF* 

HSYS 

LGOUT* 

LPINI 

MDDT% 

MRECV* 

MSEND* 

MSFRK 

MSTR* 

MTALN 

MTOPR* 

MTU% 

MUTIL* 

NODE* 

PEEK 

PLOCK 

PMCTL 

RCVOK% 

SETJB* 

SFTAD* 

SFUST* 

SJPRI 

SKED%* 

SMON 

SNOOP 

SPOOL 

SPRIW 

STAD* 

STI* 

SYERR 

TTMSG* 

USAGE 

USRIO 

UTEST 



Allows hardware address specification in disk transfers 

Makes entries to the FACT file 

Places a request in ENQ/DEQ resource queue 

Returns status of a resource 

Flushes an ARPANET host 

Returns job account information 

Allows/denies access to a protected system resource 

Returns directory information 

Halts a process 

Halts the monitor 

Logs a job out 

Loads line-printer VFU 

Enters MDDT program 

Retrieves IPCF message 

Sends IPCF message 

Starts a process in monitor mode 

Performs structure-related functions 

Associates magnetic tape drive with logical unit number 

Performs device-related functions 

Performs MT-device functions 

Performs IPCF functions 

Performs DECnet functions 

Reads monitor data 

Locks physical pages 

Controls physical memory 

Services GETOK% requests 

Sets job parameters 

Sets file data/time 

Sets file author 

Sets job priority 

Manipulates scheduler data base 

Sets monitor flags 

Performs system performance analysis 

Performs spooling-related functions 

Sets process priority 

Sets system date/time 

Simulates terminal input 

Places information in the System Error file 

Sends a message to a terminal 

Makes entries in accounting file 

Places program in user I/O mode 

Monitors executed instructions 



The capabilities for a process are be enabled by the EPCAP JSYS. 
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ACCES JSYS 552 

Gives a particular type of access to a given directory. The possible 
types of accesses are: 

1. Connecting to a directory on a given structure. 

2. Gaining owner and group access rights to directories on a 
structure without actually connecting to a directory on that 
structure. 

3. Relinquishing owner and group access rights to directories on 
a structure without disconnecting from a directory on that 
structure. 

RESTRICTIONS: some functions require WHEEL or OPERATOR capabilities 
enabled . 

When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

ACCEPTS IN AC1: BO (AC%CON) connect the job to the specified 

directory. After successful completion of 
the call, the job is connected to and has 
owner access to the directory. The job's 
default directory becomes this directory. 

Bl (AC%OWN) give the job owner access to the specified 
directory and group access to directories 
in the same groups as the specified 
directory. The job's connected directory 
is unchanged. This function cannot be 
given for another job or for a files-only 
directory. 

B2 (AC%REM) relinquish the owner access (obtained with 
the AC%OWN function) to the specified 
directory and the group access to 
directories in the same group. The job's 
connected directory is unchanged. This 
function cannot be given for another job 
or for a files-on]y directory. The 
settings of BO and Bl are ignored if B2 is 
on and the job number given is for the 
current job. 

B18-B35 length of the argument block. 

AC2: address of the argument block 

RETURNS +1: always 

Access cannot be given to a regulated structure unless the MSTR JSYS 
has been first used to increment the mount count. All structures are 
regulated by default except the primary structure (PS: on most 
systems) or any structure that has been made nonregulated with the 
MSTR JSYS. Access rights and all JFNs on the regulated structure must 
be released before the mount count can be decremented. 
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The format of the argument block is as follows 



Word Symbol 
.ACDIR 



.ACPSW 



Meaning 

Byte pointer to ASCIZ string containing the 
structure and directory name or a 36-bit 
directory number. The ASCIZ string must be 
of the form structure : <directory> . 

Byte pointer to ASCIZ string containing the 
password of the specified directory. The 
password is not required if: 

1 . the directory is on a domestic structure 
and has the same name as the user's 
logged-in directory. 

2. function AC%CON is being done and the 
directory does not require a password for 
connecting. 



2 .ACJOB Number (decimal) of job or -1 for the current 

job. The process must have WHEEL or OPERATOR 
capability enabled to give a specific job 
number other than its own. 

The ACCES monitor call can be given for another job if the type of 
access being requested is for connecting the job (AC%CON) and if the 
process executing the call has WHEEL or OPERATOR capability enabled. 

The ACCES monitor call is used to implement the CONNECT, ACCESS, and 
END-ACCESS commands of the TOPS-20 Command Language. 

Generates an illegal instruction interrupt on error conditions below. 

ACCES ERROR MNEMONICS: 



ACESX1 
ACESX3 
ACESX4 
ACESX5 
ACESX6 
ACESX7 
CNDIXl 
CNDIX5 
STRX01 
STRX02 
STRX03 



Argument block too small 

Password is required 

Function not allowed for another job 

No function specified for ACCES 

Directory is not accessed 

Directory is "files-only" and cannot be accessed 

Invalid password 

Job is not logged in 

Structure is not mounted 

Insufficient system resources 

No such directory name 
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STRX04: Ambiguous directory specification 

STRX09: Prior structure mount required 

LGINX2: Directory is "files-only" and cannot be logged into 

CAPX1: WHEEL or OPERATOR capability required 

RCDIX2: Invalid directory specification 

ARGX07: Invalid job number 

ARGX08: No such job 
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ADBRK JSYS 570 



Controls address breaks. An address break is the suspension of a 
process when a specified location is referenced in a given manner. 



RESTRICTIONS: 
ACCEPTS IN AC1 

AC2 

AC 3 

RETURNS +1 



Not available on 2020 hardware. 

function code in the left half and process handle in 
the right half 

function-specific argument 

function-specific argument 

always 



This JSYS is useful when debugging a program. For example, consider 
the problem of debugging a program consisting of a fork running 
several inferior forks mapped to the same address space. One (or 
more) of the inferior forks is erroneously referencing a particular 
address. To find out which fork(s) are referencing that address, do 
the following: 

1. Set up the software interrupt system for interrupts on 
channel 19. 

2. Perform the ADBRK .ABSET function for each inferior process, 
using the handle of the inferior process and the address 
being erroneously referenced. 

3. When a channel 19 interrupt occurs, perform an RFSTS JSYS for 
each inferior process. The interrupted process that caused 
the address break will have a code 7 (.RFABK) returned in its 
status word. 

4. Perform the ADBRK .ABGAD function for each process that 
caused an address break. This returns the address of the 
instruction that erroneously referenced the break address. 

5. Perform the RFORK JSYS to restart the process (es) halted by 
address break(s). 

6. Continue running the program and repeating the last three 
steps until the program completes execution, or it no longer 
generates address breaks. 



The ADBRK JSYS can also be used to find which instruction in a process I 
references a wrong memory location. The available functions are as | 
follows: 

Meaning 

Set address break. 

Read address break. 

Clear address break. 

Return address of break instruction. 



Code 


Symbol 





•ABSET 


1 


.ABRED 


2 


.ABCLR 


3 


. ABGAD 
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Each function is described in the paragraphs below. 

Setting address breaks - .ABSET 

This function initializes the address break facility for the specified 
process. When the process references the location in the manner for 
which the break has been set, it is suspended. Its superior receives 
a software interrupt on channel 19 (.ICIFT) if it has enabled for that 
channel. After processing the interrupt, the superior process can 
resume the inferior by executing the RFORK monitor call. 

Only one address break can be in effect for a process at any one time, 
and the break affects only the process for which it is set. If 
another process references the location on which a break is set, it is 
not affected by the break. When an address break is set in a page 
shared among processes and each process is to be suspended when it 
references the location, the ADBRK call must be executed for each 
process . 

Breaks cannot be specified for the accumulators. 

The .ABSET function requires the following arguments to be given: 

AC2: address of location on which to break. 

AC3: flag word indicating the type of reference on which to 
break. The following flags are currently defined: 

B0(AB%RED) Break on a read reference. 

Bl (AB%WRT) Break on a write reference. 

B2(AB%XCT) Break on an execute (instruction fetch) 
reference. 

Reading address breaks - .ABRED 

This function returns the current address break information for the 
specified process. It returns the following information on a 
successful return: 

AC2: address of location on which a break is set 

AC3: flag word indicating the type of reference on which the 
break will occur. The following flags are currently 
defined : 

B0(AB%RED) Break will occur on a read reference. 

B1(AB%WRT) Break will occur on a write reference. 

B2 (AB%XCT) Break will occur on an execute (instruction 
fetch) reference. 

If no address break has been set for the process, the contents of AC2 
and AC3 are zero on return. 
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Clearing address breaks - .ABCLR 

This function removes any address break that was set for the specified 
process. A program can also remove a break by executing the .ABSET 
function with AC2 and AC3 containing zero. 



Returning the address of the break instruction - .ABGAD 

This function returns in AC2 the address of the location on which the 

process encountered a break. When the location on which the break 

occurred is in a JSYS routine, the address returned is a monitor PC, 

not the address of the JSYS. The program can obtain the address of 

the JSYS by executing an RFSTS monitor call. 

Generates an illegal instruction interrupt on error conditions below. 

ADBRK ERROR MNEMONICS: 



ABRKX1 
ARGX0 2 
FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Address break not. available on this system 

Invalid function 

Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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AIC JSYS 131 



Activates specific software interrupt channels. (Refer to Section 
2.6.) 

ACCEPTS IN AC1: process handle 

AC2: 36-bit word 

Bit n on means activate channel n 



RETURNS 



+1: always 



The DIC monitor call can be used to deactivate specified software 
interrupt channels. 

Generates an illegal instruction interrupt on error conditions below. 

AIC ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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ALLOC JSYS 520 



Allocates a device to a job or to the device pool of the monitor's 
resource allocator. A device under control of the monitor's resource 
allocator cannot be opened or assigned by any job other than the one 
to which it is currently allocated. When the allocated device is 
deassigned, it is returned to the monitor's resource allocator. 



RESTRICTIONS: 

ACCEPTS IN AC1 

AC 2 

AC 3 

RETURNS +1 

+ 2 



requires WHEEL or OPERATOR capabilities enabled 

function code (.ALCAL) 

device designator 

job number, -1, or -2 

failure, error code in AC1 

success 



If AC3 contains a job number, then the designated device is allocated 
to that job. 

If AC3 contains -1, then the device is returned to the pool of devices 
available to all users of the system (the device is no longer 
allocated). This is the initial state of all devices. 



If AC3 contains -2, then the device 
resource allocator's pool of devices. 



is assigned to the monitor 



Once a job assigns or opens a nonallocated device (a device not under 
control of the resource allocator), the resource allocator cannot take 
the device from the job. The resource allocator can allocate the 
device, however, to the job that currently has it. Then, when the job 
releases the device, the resource allocator gets control of the 
device . 

When a job returns control of a device to the system resource 
allocator, the allocator receives an IPCF packet. The flag word 
(.IPCFL) of the packet descriptor block contains a code that indicates 
the message was sent by the monitor. This code is l(.IPCCC) in the 
IP%CFC field (bits 30-32) . 

The first word of the IPCF packet data block contains .IPCSA, which 
means that the second and subsequent words contain designators for 
devices returned to the control of the resource allocator. 

.IPCFL/<.IPCCOB32 

DATA/. IPCSA 

DATA+1/device designator 
DATA+2/device designator 

The ALLOC monitor call requires the process to have WHEEL or OPERATOR 
capability enabled. 
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ALLOC ERROR MNEMONICS 



ALCX1 
ALCX2 
ALCX3 
ALCX4 
ALCX5 
ALCX6 

DEVX1: 



Invalid function 

WHEEL or OPERATOR capability required 

Device is not assignable 

Invalid job number 

Device already assigned to another job 

Device assigned to user job, but will be given to allocator 
when released 

Invalid device designator 
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ARCF JSYS 247 



Performs operations pertaining to the archive and virtual disk 
systems. These include requesting archival and migration, requesting 
retrieval, and setting archive status and tape information for a file. 



RESTRICTIONS 



ACCEPTS IN AC1 



Some functions require WHEEL or OPERATOR capabilities 
enabled . 

J FN 



AC2: Function code. The available functions and their 
argument blocks are described below. 

AC3: (Function-dependent, normally 0) 

Code Symbol Function 

.ARRAR Sets/clears AR%RAR (in . FBBBT of the FDB) , 

activating or deactivating a user request for 
archival. The value .ARSET (1) in AC3 requests 
an archive while .ARCLR (0) clears the request. 
Specifying .ARSET in AC3 sets AR%NDL (in .FBBBT 
of the FDB) and requests that the contents of 
the file not be flushed from disk upon 
archival . 

1 .ARRIV Sets/clears AR%RIV (in .FBBBT of the FDB), 

activating or deactivating a system request to 
migrate a file from disk to tape. The value 
.ARSET in AC3 requests migration while .ARCLR 
clears the request. This function requires 
WHEEL or OPERATOR capabilities to be enabled. 

2 .AREXM Sets/clears AR1EXM (in .FBBBT of the FDB), 

activating or deactivating exemption from 
involuntary migration. Code .ARSET (1) in AC3 
sets AR%EXM, while code .ARCLR (0) in AC3 
clears AR%EXM. This function requires WHEEL or 
OPERATOR capabilities to be enabled. 

3 .ARRFR Request that the contents of a file be restored 

to disk. The contents of AC3 determine if 
.ARRFR waits or returns without waiting for the 
contents of the file to be restored to disk. 



Options for AC3 
BO AR%NMS 



Do not wait for the file 
restored . 



to be 



Bl 



AR%WAT 



Wait until the file is restored. 



ARDIS Discard tape information. Clears FB%ARC (if 
set), .FBTP1, .FBTP2, .FBTSN, .FBTFN, and 
.FBTDT. The file must be on line for the 
function to succeed. Options for AC3 (which 
require WHEEL or OPERATOR privileges enabled to 
be used separately) : 

BO AR%CRl Clear information for run 1. 
Bl AR%CR2 Clear information for run 2. 
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Code Symbol Function 

5 .ARSST Set tape information for a file. This function 
is used to set information for the first, 
second, or both tape runs. AR%01 and AR%02 are 
used together when restoring files to disk. It 
requires enabled WHEEL or OPERATOR privileges. 

AC3 contains a pointer to an argument block as 
follows: 

Word Symbol Contents 

.AROFL Flags: 

BO(AR%01) Set information for 
run 1 . 

B1(AR%02) Set information for 
run 2 . 



.ARTP1 
. ARSF1 

.ARTP2 
.ARSF2 

•ARODT 
•ARPSZ 



B2(AR%OFL) Delete disk contents 
of file when done. 
Requires both run 1 
and run 2 tape 
information to be 
set. 

B3(AR%ARC) Set FB%ARC in the 
FDB (archive the 
file.) 

B4 (AR%CRQ) Clear archive and/or 
migration requests 
(clear AR%RAR and 
AR%RIV. ) 

Tape 1 identification. 

TSN 1,,TFN 1 - Tape saveset 

number in the left half and 

tape file number in the right 
half. 

Tape 2 identification. 

2 - similar 



TSN 2,,TFN 
.ARSFl. 



to 



time and date of tape write in 
internal format; implies 
present time. 

Number of pages in the file. 
This word can be set only if 
AR%01 and AR%02 are set first. 
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Code Symbol Function 

6 .ARRST Restore contents of a file to disk. AC3 

contains a JFN for a temporary file (created by 
DUMPER) that contains the data for an archived 
file that is currently off-line. After .FBADR, 
.FBBSY, and .FBSIZ are copied, the temporary 
file is deleted. Both files must be on the 
same device or structure, and enabled WHEEL or 
OPERATOR capabilities are required. 

7 .ARGST Get tape information for file. AC3 contains 

the address of an argument block that has the 
same format as the block for .ARSST. 

10 .ARRFL The restore for this file has failed. Sets 

AR%RFL in .FBBBT to notify a waiting process 
that the retrieval request cannot be completed. 
Requires WHEEL or OPERATOR capabilities. 

11 .ARNAR Resist involuntary migration. Sets or clears 

AR%NAR in .FBBBT. Using .ARSET in AC3 causes 
resist to be set, while using .ARCLR clears 
resist. 

ARCF ERROR MNEMONICS: 

CAPX1: WHEEL or OPERATOR capabilities required 

Invalid function code 

File already has archive status 



ARGX02 
ARCFX2 
ARCFX3 

ARCFX4 
ARCFX5 
ARCFX6 
ARCFX7 
ARCFX8 
ARCFX9 
ARCX10 
ARCH11 
ARCH12 
ARCX13 
ARCX14 
ARCX15 



Cannot perform ARCF functions on nonmultiple directory 
devices 

File is not on line 

Files are not on the same device or structure 

File does not have archive status 

Invalid parameter for .ARSST 

Archive not complete 

File not off line 

Archive prohibited 

Archive requested, modification prohibited 

Archive requested, delete prohibited 

Archive system request not completed 

Restore failed 

Migration prohibited 
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TOPS-20 MONITOR CALLS 
(ARCF) 



ARCX16: Cannot exempt off-line, archived, or archive-pending files 

ARCX17: FDB improper format for ARCF 

ARCX18: Retrieval wait cannot be fulfilled for waiting process 

ARCX19: Migration already pending 



3-14 



TOPS-20 MONITOR CALLS 
(ASND) 

ASND JSYS 70 

Assigns a device to the caller. The successful return is given if the 
the device is already assigned to the caller. 

ACCEPTS IN AC1: device designator 

RETURNS +1: failure, error code in AC1 

+2: success 

The PELD call can be used to release devices assigned to the caller. 

ASND ERROR MNEMONICS: 

DEVX1 : Invalid device designator 

DEVX2: Device already assigned to another job 

ASNDX1: Device is not assignable 

ASNDX2: Illegal to assign this device 

ASNDX3: No such device 

DSMX1: File(s) not closed 
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TOPS-20 MONITOR CALLS 
(ASNSQ) 

ASNSQ JSYS 752 



Assigns a special message queue to a job. See ARPANET manual for more 
detail s . 



RESTRICTIONS: 

ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



for ARPANET systems only. Requires NET WIZARD 
capabilities enabled. 

mask 

header value 

failure, error code in AC1 

success, special message queue assigned with special 
queue handle in AC1 



ASNSQ ERROR MNEMONICS: 

NTWZX1: NET WIZARD capability required 

ASNSX1: Insufficient system resources (All special queues in use) 

ASNSX2: Link(s) assigned to another special queue 
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TOPS-20 MONITOR CALLS 
(ATACH) 

ATACH JSYS 116 



Detaches the specified job from its controlling terminal (if any) and 
optionally attaches it to a new controlling terminal. A 
console-attached entry is appended to the accounting data file. 



RESTRICTIONS: 



ACCEPTS IN AC1: 



RETURNS 



AC2: 

AC3: 
AC4: 

+ 1: 
+ 2: 



some functions require WHEEL or OPERATOR capabilities 
enabled. 

B0(AT%CCJ) generate a CTRL/C interrupt to the lowest 
process in the job that is enabled for a 
CTRL/C interrupt if the job is currently 
attached to another terminal. If this bit 
is not set or if the job is currently not 
attached to another terminal, the job 
simply continues running when it is 
attached . 

Bl (AT%NAT) do not attach. Prevents both the 
detaching of the job from its terminal and 
the attaching of a remote job to the local 
terminal. Is a no-op unless the remote 
job has a controlling terminal, in which 
case the remote job is detached and 
remains detached. This bit in effect 
makes ATACH like a remote DTACH. 

B2(AT%TRM) attach the given job to the terminal 
specified in AC4. If this bit is not set, 
the job is attached to the controlling 
terminal of the caller. 

B18-B35 job number of the desired job. 
(AT%JOB) 

user number under which the job to be attached is 
logged in. The user number can be obtained with the 
RCUSR monitor call. 

byte pointer to an ASCIZ password string in the 
caller's address space. 

number of the terminal to be attached to the 
specified job. This argument is required if 
B2(AT%TRM) is set. 

failure, error code in AC1. 

success. If there is a logged-in job currently 
attached to the specified terminal, it is detached 
and primary I/O for that job is not redirected. 
Thus, if a process has primary I/O from the 
controlling terminal, it will block when it attempts 
primary I/O and will continue when it is reattached 
and a character is typed. A job attached to the 
terminal but not logged in is killed. 
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(ATACH) 



It. is legal to attach to a job that has a controlling terminal if one 
of the following conditions exists: 

1. The job is logged in under the same user name as the job 
executing the ATACH. 

2. The job executing the ATACH supplies the correct password of 
the job it is attaching to. 

3. The job executing the ATACH has WHEEL or OPERATOR capability 
enabled . 

4. The job executing the ATACH has ownership of the job because 
it created the job (and maintained ownership) with the CRJOB 
call. 

If the controlling terminal is a PTY, a password is not required in 
the following cases: 

1. The owner of the PTY has WHEEL or OPERATOR capability 
enabled . 

2. The specified job is logged in with the same name as the 
owner of the PTY. 

The DTACH monitor call can be used to detach the controlling terminal 
from the current job. 

ATACH ERROR MNEMONICS: 



ATACX1 
ATACX2 
ATACX3 
ATACX4 
ATACX5 
ATACX6 
ATACX7 



Invalid job number 

Job already attached 

Incorrect user number 

Invalid password 

This job has no controlling terminal 

Terminal is already attached to a jol 

Illegal terminal number 



TOPS-2 Version 5 
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TOPS-20 MONITOR CALLS 
(ATI) 

ATI JSYS 137 

Assigns a terminal code to a software interrupt channel. (Refer to 
Section 2.6.) This call also sets the corresponding bit in the 
process' terminal interrupt mask. (Refer to the STIW and RTIW monitor 
calls. ) 

ACCEPTS IN AC1: terminal interrupt code ,, channel number 
(Refer to Section 2.6.6.) 

RETURNS +1: always 

If there is no controlling terminal (if the job is detached), the 
assignments are remembered and are in effect when a terminal becomes 
attached . 

The DTI monitor call can be used to deassign a terminal code. 

Generates an illegal instruction interrupt on error conditions below. 

ATI ERROR MNEMONICS: 

TERMX1: Invalid terminal code 

ATIX1: Invalid software interrupt channel number 

ATIX2: Control-C capability required 
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TOPS-20 MONITOR CALLS 
(ATNVT) 

ATNVT JSYS 274 



Creates the Network Virtual Terminal (NVT) connection. See the 
ARPANET manual for more details. 



RESTRICTIONS 



for use with ARPANET only 



ACCEPTS IN AC1: flag bits in the left half and the JFN of the opened 
receive connection in the right half 

AC2: JFN of the opened send connection 

RETURNS +1: failure, with error code in AC1 

+2: success, with terminal designator specific to this 
NVT in AC1 



Flags for AC1: 
Bit Symbol 
B2 AT%NTP 



Meaning 

If set, this bit indicates new TELNET protocol. 
If clear, this bit indicates old TELNET protocol. 



ATNVT ERROR MNEMONICS 



ATNX1 

ATNX2 

ATNX3 

ATNX4 

ATNX5 

ATNX6 

ATNX7 

ATNX8 

ATNX9 

ATNX10 

ATNX11 

ATNX12 

ATNX13 



Invalid receive JFN 

Receive JFN is not open for read 

Receive JFN is not open 

Receive JFN is not a network connection 

Receive JFN has been used 

Receive connection has been refused 

Invalid send JFN 

Send JFN is not open for write 

Send JFN is not open 

Send JFN is not a network connection 

Send JFN has been used 

Send connection has been refused 

Insufficient system resources (no NVTs) 
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TOPS-20 MONITOR CALLS 
(BIN) 



BIN 



JSYS 50 



Inputs the next byte from the specified source. When the byte is read 
from a file, the file must first be opened, and the size of the byte 
given, with the OPENF call. When the byte is read from memory, a 
pointer to the byte is given. This pointer is updated after the call. 

ACCEPTS IN AC1: source designator 

RETURNS +1: always, with the byte right-justified in AC2 

If the end of the file is reached, AC2 contains instead of a byte. 
The program can process this end-of-file condition if an ERJMP or 
ERCAL is the next instruction following the BIN call. 

The BOUT monitor call can be used to output a byte sequentially to a 
destination. 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 

BIN ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX5 

IOX1 

IOX4 

IOX5 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

File is not open for reading 

End of file reached 

Device or data error 
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TOPS-20 MONITOR CALLS 
(BKJFN) 

BKJFN JSYS 42 



Backs up the source designator's pointer by one byte 



ACCEPTS IN AC1 

RETURNS +1 

+ 2 



source designator 

failure, error code in AC1 

success, updated string pointer in AC1 , if pertinent 
(This return actually decrements the pointer.) 



The BKJFN call, when referring to a terminal, can be executed only 
once per TTY to back up one character. The BKJFN call cannot be 
issued again for the same TTY unless the input buffer has been cleared 
(with the CFIBF JSYS) or an input JSYS is executed for the TTY. 

BKJFN, when referring to other designators, can be executed more than 
once in succession. 



This call cannot be used with the DECnet devices SRV: 
BKJFN ERROR MNEMONICS: 



or DCN: 



DESX1 

DESX2 

DESX3 

DESX5 

BKJFX1 

SFPTX2 

SFPTX3 

TTYX01 



Invalid source/destination designator 
Terminal is not available to this job 
JFN is not assigned 
File is not open 

Illegal to back up terminal pointer twice 
Illegal to reset pointer for this file 
Invalid byte number 
Line is not active 



3-22 



TOPS-20 MONITOR CALLS 
(BOOT) 

BOOT JSYS 562 



Performs basic maintenance and utility functions required for loading 
and dumping communications software. The TOPS-20 system process that 
performs these functions uses a DIGITAL-suppl ied protocol to perform 
them. 

On 2040,2050, and 2060 hardware, the BOOT JSYS is used to load and 

dump a PDP-11 connected to a DTE20. On 2020 hardware, the BOOT JSYS 

loads and dumps the KMC11 microcode, dumps line counters, controls 

DDCMP on a line, performs multidrop functions, and loads and dumps 
front-end images. 



RESTRICTIONS: 

ACCEPTS IN AC1 

AC2 

RETURNS +1 



requires WHEEL or OPERATOR capabilities enabled. 
Some functions are hardware specific. 

function code 

address of argument block 

always 



The available functions and their argument blocks are described below. 
Note that in the discussion of each function, the applicable processor 
is indicated as follows: 

Group Processor 

A 2020 

B 2040,2050,2060 



BOOT JSYS Functions: 
Code Symbol 
. BTROM 



Meaning 

Puts the line in MOP (Maintenance-Operation 
Protocol) mode and activates the bootstrap ROM 
in the front end. 

Applicable Hardware: processor group A, B 

Processor Group A Argument Block 

.BTPRT Line number 

Activates the hardware ROM bootstrap in the 
communications front end. 

Processor Group B Argument Block 

.BTDTE DTE-20 number 

1 .BTERR Error status flags returned on 

failure of the call 
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TOPS-20 MONITOR CALLS 
(BOOT) 



Code Symbol Meaning 

1 .BTLDS Load a secondary bootstrap program into the 
communications front end. The secondary 
bootstrap, with a maximum size of 256 PDP-11 
words, is loaded using the ROM bootstrap. The 
data to be loaded must be packed as two 16-bit 
PDP-11 words left justified in each 36-bit 
word. The entire bootstrap program must be 
loaded at once, and the caller blocks until the 
transfer is complete. 

Applicable Hardware: processor group A,B 

Processor Group A Argument Block 

.BTPRT Line number 



BTSEC 



Not used, must be zero 

Address of bootstrap program to 
be loaded 



Processor Group B Argument Block 

.BTDTE DTE-20 number 

1 .BTERR Error status flags returned on 

failure of the call 

2 .BTSEC Address of bootstrap program to 

be loaded 

.BTLOD Load the communications front-end memory using 
the previously loaded secondary or tertiary 
bootstrap program. The bootstrap program in 
the front end must abide by the protocol for 
DTE-20 transfers: the first two bytes of data 
supplied by the caller must be a count of the 
remaining number of data bytes. 

Applicable Hardware: processor group A,B 

Processor Group A Argument Block 

.BTDTE line number 

1 Not used and must be zero 

2 Not used and must be zero 

3 Not used and must be zero 

4 .BTCNT Number of bytes to transfer 

5 .BTLPT Pointer to data to be loaded 
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TOPS-20 MONITOR CALLS 
(BOOT) 

Code Symbol Meaning 

2 .BTLOD Processor Group B argument block 
(Cont. ) 

.BTDTE DTE-20 number 

1 .BTERR Error status flags returned on 

failure of the call 

2 Not used and must be zero 

3 .BTFLG User-supplied flag word 

B0(BT%BEL) Send a doorbell to 
the front end to 
indicate when the 
setup is complete 
and the transfer can 
begin. 

4 .BTCNT Number of bytes to transfer 

5 .BTLPT Pointer to data to be loaded 

3 . BTDMP Dump the communications front-end memory using 

the ROM bootstrap program. The caller must 
activate the ROM bootstrap (function .BTROM) 
before dumping memory. Subsequent .BTDMP 
functions to dump memory start where the 
previous dump terminated unless the ROM 
bootstrap is activated again by a .BTROM 
function. The caller blocks until the transfer 
is complete. 

Applicable Hardware: processor group B 

Argument Block 

DTE-20 number 

Error status flags returned on 
failure of the call 

Not used and must be zero 

User-supplied flag word. This 
word is not used and must be 
zero. 

4 .BTCNT Number of bytes to transfer 

5 .BTDPT Pointer to where the data is to 
be dumped in TOPS-20 






.BTDTE 


1 


.BTERR 


2 




3 


.BTFLG 
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(BOOT) 

Code Symbol Meaning 

4 .BTIPR Generates and links a DDCMP Station Table. 

Starts up lines and terminals not previously 
known to the system. (Must be issued once for 
each multidrop terminal being started up.) 

Applicable Hardware: Processor group A (See 
below for group B.) 

Processor Group A Argument Block 

.BTPRT Drop,, line number 

1 . BTPRV Version number of protocol to be 

used 

Processor Group A protocol types are: 

Symbol Meaning 

•VNDDC (2) DDCMP protocol 

.VNMOP (3) MOP (DDCMP maintenance) mode 

.VNCNL (4) Controller loopback 

.VNCBL (5) Cable loopback 

.BTIPR Initialize the protocol to be used with this 
communications front end. After successful 
execution of this function, TOPS-20 processes 
interrupts from the given DTE-20. 

Applicable Hardware: processor group B 

Processor Group B Argument Block 

.BTDTE DTE-20 number 

1 .BTPRV Version number of the protocol 

to be used 

Processor Group B protocol types are: 

Symbol Meaning 

•VN20F (0) RSX20F protocol 
.VNMCB (1) MCB DECNET protocol 

5 . BTTPR Stop the protocol currently running on this 

communications front end or line. After 
successful execution of this function, TOPS-20 
ignores interrupts from the given DTE-20 or 
1 ine. 

Applicable Hardware: processor group A,B 

Processor Group A Argument Block 

.BTPRT Line number 

Processor Group B Argument Block 

.BTDTE DTE-20 number 
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(BOOT) 

Code Symbol Meaning 

6 . BTSTS Return the status type of the protocol running 

on the communications front end to the 
specified DTE or line. Also returns the name 
of the adjacent DECNET node for this front end. 

Applicable Hardware: processor groups A,B 

Processor Group A Argument Block 

.BTPRT Line number 

1 .BTCOD Returned protocol version type. 

If no protocol is running, this 
word contains -1. 

Processor Group A protocol types are: 

Symbol Meaning 

.VNDDC (2) DDCMP protocol 

.VNMOP (3) MOP (DDCMP maintenance) mode 

.VNCNL (4) Controller loopback 

.VNCBL (5) Cable loopback 

Processor Group B Argument Block 

.BTDTE DTE-20 number 

1 .BTCOD Returned protocol version type. 

If no protocol is running, this 
word contains -1. 

Processor Group B protocol types are: 

Symbol Meaning 

.VN20F (0) RSX20F protocol 
•VNMCB (1) MCB DECNET protocol 

7 .BTBEL Block until a signal (doorbell) to TOPS-20 is 

initiated by the communications front end. 
This function is used to synchronize the caller 
with the bootstrap program in the front end. 

Applicable Hardware: processor group B 

Argument Block 

.BTDTE DTE-20 number 
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(BOOT) 



Code 
10 



Symbol 
.BTRMP 



.BTRMP 



Meaning 

Read data from the communications front, end 
using the previously loaded secondary or 
tertiary bootstrap program. 



Applicable Hardware: processor group A 
below for group B.) 



Processor Group A Argument Block 

.BTPRT Line number 

Not used and must be zero 
Not used and must be zero 
Not used and must be zero 
Number of bytes to transfer 



(See 



BTCNT 
BTLPT 



Pointer to where the data is 
be dumped in TOPS-20 



to 



Read data from the communications front end 
using the previously loaded secondary or 
tertiary bootstrap program. The bootstrap 
program must abide by the protocol for DTE-20 
transfers. The first two bytes of data are 
interpreted as a count of the remaining number 
of bytes of data. 

Applicable Hardware: processor group B 

Processor Group B Argument Block 

.BTDTE DTE-20 number 

1 .BTERR Error status flags returned on 

failure of the call 

2 Not used and must be zero 

3 .BTFLG User-supplied flag word 

B0(BT%BEL) Send a signal 
(doorbell) to 
TOPS-20 to indicate 
the transfer is 
finished . 

4 .BTCNT Maximum number of bytes to 

transfer. After successful 
execution of this function, this 
word is updated to reflect the 
actual number of bytes 
transferred. 

5 . BTMPT Pointer to where data is to be 

placed 
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Code Symbol Meaning 

11 .BTKML Load a KMC11. This function will optionally 
load the CRAM, DRAM, and the four UNIBUS 
registers. Before the KMC11 is loaded, the 
system verifies that each bit in UNIBUS 
registers can be set and cleared. Before the 
DRAM is loaded, the system verifies that each 
bit in the entire DRAM can be set and cleared. 
After the CRAM, DRAM, and registers are loaded, 
they are verified to ensure that the data was 
properly loaded. If the register data is not 
supplied, the UNIBUS registers are cleared 
before the KMC11 is started. 

Applicable Hardware: processor group A 

Argument Block 

.BTKMC KMC11 address 



BTKER 



2 


.BTKCC 


3 


.BTKCP 


4 


.BTKDC 


5 


.BTKDP 


6 


.BTKRC 


7 


.BTKRP 


8 


.BTKSA 



Error flags returned in left 
half and bad data word (16 bit) 
returned in right half 

BO (BT%CVE) CRAM verify error 

Bl (BT%DVE) DRAM verify error 



B2 (BT%RVE) Register 
error 

Count of CRAM data 



verify 



Pointer to CRAM data (16-bit 
data) 



Count of DRAM data 

Pointer to DRAM data 
data) 

Count of register data 



(8-bit 



Pointer to register data (16-bit 
data) 

If bit of this word is set, 
then the right halfword contains 
the starting address; 
otherwise, this word is ignored. 

BO (BT%KSA) Right halfword is 
set; start KMC11 
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(BOOT) 



Code 
12 



13 



Symbol 
.BTKMD 



•BTRLC 



Meaning 

Dump a KMC11. This function optionally clumps 
the CRAM, DRAM, and registers if space is 
provided. The registers are SELO, SEL2, SEL4, 
SEL6, INDATA, OUTDATA, INBA, OUTBA , and 
MISC*400+NPR. 



Applicable Hardware: processor group A 

Argument Block 

.BTKMC KMC11 address 

Not used, must be zero 
Count of CRAM data 



.BTKCC 
.BTKCP 

.BTKDC 
.BTKDP 

.BTKRC 
.BTKRP 



Pointer to CRAM data (16-bit 
data) 

Count of DRAM data 

Pointer to DRAM data (8-bit 
data) 

Count of register data 

Pointer to area for storing 
register data (16-bit data) 



Return line counters, 
positive numbers. 



All 



counters are 



Applicable Hardware: processor group A 

Argument Block 

.BTPRT Port number 



1 



.BTZTM 



.BTSCC 



.BTSCP 



•BTRCC 



.BTRCP 



.BTTCC 



.BTTCP 



Time since counters were last 
zeroed 



Number of status counts 
return 



to 



Pointer to area 
status counters 



to 



receive 



Number of receive counts to 
return 

Pointer to area to store receive 
counters 

Number of transmit counts to 
return 



Pointer to area 
transmit counters 



to 



receive 
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(BOOT) 

Code Symbol Meaning 

14 .BTCLI Convert line id to port number 

Applicable Hardware: processor groups A,B 
Argument Block 

.BTPRT Port number 

1 .BTLID Pointer to ASCIZ line id 

15 .BTCPN Convert NSP port number to line id 

Applicable Hardware: processor groups A,B 
Argument Block 

.BTPRT Port number 

1 .BTLID Pointer to ASCIZ line id 

16 .BTSTA Set the station's polling state to active to 

cause the terminal to be polled, or set it to 
idle to prevent the terminal from being polled. 

Applicable Hardware: VT62 on processor group A 

Argument Block 

.BTPPT Drop,, Line number 

1 .BTCOD Flags: 

.BTACT Set line active 

1 .BTIDL Set line idle 

16 .BTD60 Send a message to or receive a message from a 
front end (a DN60) using the .VND60 protocol. 
The argument block controls whether this 
function sends or receives a message. 

Applicable Hardware: DN60 on KL-10 Model B 
processor 

Argument Block 

.BT6DTE DTE number 

1 .BT6ERR Error flags (returned) : 

30 D6%BDP The data byte 

pointer passed 
in the argument 
block is bad. 

31 D6%ARD The PDP-11 

attempted to 

send data when 

none was 
expected . 

32 D6%TRS DTESRV timed 

out waiting for 
response header 
from the front 
end . 
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TOPS--20 MONITOR CALLS 
(BOOT) 



Code Symbol 
16 .BTD60 (Cont.) 



Meaning 



33 D6%TDT 



34 D6%TPO 



35 D6%NT6 



DTESRV timed 
out waiting for 
data from the 
front end. 
DTESRV timed 
out waiting for 
the DTE to be 
free. Another 
job is using 
the DTE and is 
probably hung. 
The front end 
is not running 
the DN60 
protocol . 



2 


.BT6HBC 


Number of bytes 
in the DN60 
header 


2 


.BT6HDR 


Address at 
which the DN60 
header begins. 
This header 
contains 4 
words, which 
contain 4 8-bit 
bytes each. 


3 


.BT6DBC 


Number of bytes 
of data. 


4 


.BT6PTR 


Pointer to the 
first byte of 
the data 


5 


.BT6TMR 


Time the 
request was 
made (returned) 


6 


.BT6TAS 


Time DTE was 

assigned 

(returned) 


7 


.BT6THQ 


The time 
TOPS-20 queued 
the header to 
the DTE 


10 


.BT6TRD 


The time 


11 


•BT6TDD 


The time 


12 


.BT6TFR 


The time 
TOPS-20 

satisfied the 
request 
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(BOOT) 

Code Symbol Meaning 

17 .BTSSP Set the start-|up priority value. This value 
specifies the relative frequency at which 
start-lups are attempted. That is, for a value 
of N, each active station is polled N times for 
each DDCMP start. This is used to prevent 
unresponsive stations from deteriorating 
performance of a multidrop line. N is a 4-bit 
field in which truncation occurs if the field 
size is exceeded. If N is zero, stations in 
start-up mode will be polled along with active 
stations . 

Applicable Hardware: VT62 on processor group A 

Argument Block 

.BTPRT Line number 

1 .BTSPR Start priority count 

20 .BTSTP Set the polling priority. This parameter is 

maintained in the Station Table to specify the 
relative polling priority of a station. If 
this feature is not used, all priority values 
default to 1 and polling proceeds in a round 
robin manner. 

Applicable Hardware: VT62 on processor group A 

Argument Block 

.BTPRT Drop,, line number 

1 .BTPRI Priority value 

Typical range: 1 (high) to 5 
(low) 

21 .BTSDD Send a DDCMP message. A DDCMP message will be 

queued for transmission on the specified line. 

Applicable Hardware: Processor group A 

Argument Block 

Drop, , 1 ine 

Address of message or byte 

pointer to message 

Byte count of message 






.BTPRT 


1 


.BTMSG 


2 


.BTLEN 
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(BOOT) 



Code 
22 



Symbol 
.BTRDD 



23 



BTCHN 



Meaning 

Receive a DDCMP message. An item from the 
DDCMP input queue is returned or .BTLEN is set 
to zero if the queue is empty. Items on the 
queue will be data segments, completion 
postings, or status postings (station going up 
or down) . 

Applicable Hardware: Processor group A 

Argument Block 





1 


.BTPRT 
.BTMSG 


2 


.BTLEN 



Line number 
Address of buffer 
pointer to buffer 
Size of user buffer 



or 



byte 



For data messages, the byte 
count of the message is returned 
in .BTLEN. If the buffer is too 
small, the JSYS will fail. For 
completion postings, the 
following are returned in 
.BTLEN: 



ET%CTL (1B0) + 
station came up 

BT%CTL (1B0) + 
station went down 



BTSUP (1) 
BTSDW (2) 



BT%CTL (1B0) + .BTCMP (3) 
transmit complete 



BT%CTL (1B0) + .BTSSF (4) 
start-up failed 



a 



.BTPRT will contain the drop 
that this message pertains to. 

Set the interrupt channel so that software 
interrupts will be generated when input data is 
available . 

Applicable Hardware: Processor group A 

Argument Block 

.BTPRT Drop,, line number 

1 .BTCOD Software interrupt channel 



3-34 



TOPS-20 MONITOR CALLS 
(BOOT) 

Code Symbol Meaning 

24 .BTSLS Set type of line service to be done on a 
synchronous communications line. 

Applicable Hardware: Processor group A 

Argument Block 

.BTPRT Drop,, line number 

1 .BTCOD Define protocol 

Protocol values can be: 

.BTNSP NSP protocol 

1 .BTDCP DDCMP protocol 



The error status flag returned in word .BTERR on failure of a BOOT 
call (for group B processors) contains front-end reload status bits 
recorded in the system error file. Refer to the SPEAR manual for an 
explanation of these status bits. Note that error logging is not 
performed for group A processors. 

Generates an illegal instruction interrupt on error conditions below. 

BOOT ERROR MNEMONICS: 

BOTX01: For group A processors, this message indicates an illegal 
line number. For group B processors, this message indicates 
an invalid DTE-20 number. 



BOTX02 
BOTX03 
BOTX04 
BOTX0 5 
BOTX06 
BOTX07 
BOTX08 
BOTX09 
BOTX10 
BOTX11 
B0TX12 
B0TX13 
B0TX14 
B0TX15 
B0TX16 
B0TX17 



Invalid byte size 

Invalid protocol version number 

Byte count is not positive 

Protocol initialization failed 

GTJFN failed for dump file 

OPENF failed for dump file 

Dump failed 

To -10 error on dump 

To -11 error on dump 

Failed to assign page on dump 

Reload failed 

-11 didn't power down 

-11 didn't power up 

ROM did not ACK the -10 

-11 boot program did not make it to -11 

-11 took more than 1 minute to reload; will cause retry 
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| BOTX18: Unknown BOOT error 

CAPX1: WHEEL or OPERATOR capability required 
ARGX02: invalid function 
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TOPS-20 MONITOR CALLS 
(BOUT) 

BOUT JSYS 51 



Outputs a byte sequentially to the specified destination. When the 
byte is written to a file, the file must first be opened, and the size 
of the byte given, with the OPENF call. When the byte is written to 
memory, AC1 contains a pointer to the location in which to write the 
byte. This pointer is updated after the call. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 



destination designator 

the byte to be output, right-justified 

always 



The BIN monitor call can be used to input a byte sequentially from a 
source . 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
descr iption. ) 

BOUT ERROR MNEMONICS: 



DESXl 
DESX2 
DESX3 
DESX5 
10X2: 
10X5: 
10X6: 
10X11 
10X33 
10X34 
10X35 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

File is not open for writing 

Device or data error 

Illegal to write beyond absolute end-of-file 

Quota exceeded 

TTY input buffer full 

Disk full 

unable to allocate disk - structure damaged 
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CACCT JSYS 4 



Changes the account for the current job. 
RESTRICTIONS: 



ACCEPTS IN AC1 



RETURNS 



+ 1 
+ 2 



When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

byte pointer that points to the new account string in 
the calling program's address space. This call reads 
the string until a null byte is read, or until 39 
characters are read. 

If executed in section 0, this AC can contain a local 
byte pointer or an account number. The account 
number must be in bits 3-35, and bits 0-2 must 
contain 5. 

failure, error code in AC1 

success, updated string pointer in AC1 



The CACCT call sets the current account for the job to the specified 
account. Subsequent session charges will be to this new account. 
This call also validates the account given if the account validation 
facility is enabled. (Refer to the . SFAVR function of the SMON/TMON 
monitor call . ) 

The GACCT monitor call can be used to return the account for the 
current job. 

CACCT ERROR MNEMONICS: 



CACTX1 
CACTX2 
VACCXO 
VACCX1 



Invalid account identifier 

Job is not logged in 

Invalid account 

Account string exceeds 39 characters 
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(CFIBF) 

CFIBF JSYS 100 



Clears the designated file input buffer. 

ACCEPTS IN AC1: source designator 

RETURNS +1: always 

Is a no-op if the source designator is not associated with a terminal. 

The CFOBF monitor call can be used to clear a designated file output 
buffer . 

Generates an illegal instruction interrupt on error conditions below. 

CFIBF ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX5: File is not open 

DEVX2: Device already assigned to another job 

TTYX01 : Line is not active 
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(CFOBF) 

CFOBF JSYS 101 



Clears the designated file output buffer. 

ACCEPTS IN AC1: destination designator 

RETURNS +1: always 

Is a no-op if the destination designator is not associated with a 
terminal . 

The CFIBF call can be used to clear a designated file input buffer. 

Generates an illegal instruction interrupt on error conditions below. 

CFOBF ERROR MNEMONICS: 



DESX1 
DESX3 
DESX5 
DEVX2 
TTYX01 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

Device already assigned to another job 

Line is not active 
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(CFORK) 

CFORK JSYS 152 

Creates a process inferior to the calling process. (Refer to Section I 
2.7.) | 



ACCEPTS IN AC1 



RETURNS 



AC2 

+ 1 
+ 2 



BO (CR%MAP) make the inferior process 1 map the same as 
the current process 1 map by means of 
indirect pointers. If this bit is not on, 
the inferior process will have no pages in 
its map. If desired, the creating process 
can then use PMAP or GET to add pages to 
the inferior's map. 

Bl (CR%CAP) make the inferior process 1 capabilities 
the same as the current process'. If this 
bit is not on, the inferior process has no 
special capabilities. 

B3(CR%ACS) set the inferior process' ACs from the 
block whose address is in AC2. If this 
bit is not on, the inferior process' ACs 
are set to 0. 

B4 (CR%ST) set the PC of the inferior process to the 
value in the right half of AC1 and start 
the process. If this bit is not on, the 
inferior process is not started, and the 
right half of AC1 is ignored. (Also see 
the XSFRK% call.) 

B18-B35 PC value for the inferior process if CR%ST 
(CR%PCV) is on. 

address of 20 (octal) word block (optional). This 
block contains the AC values for the inferior 
process. (Refer to bit CR%ACS above.) 

failure, error code in AC1 

success, relative process handle in AC1 



The inferior process receives the same primary input and output JFNs 
as the current process. However, the primary input and/or output 
files may be changed with the SPJFN monitor call. 

The CR%MAP argument in AC1 allows the inferior to see the same address 
space as that of the superior. The inferior process will have read 
and write access to the superior's address space. The pages are 
shared, and changes made by one process will be seen by the other. 

CFORK creates a nonvirgin process if: 

1. CR%ST is set and 

2. CR%ACS and/or CR%MAP is set. 

CFORK creates an execute-only process if bit CR%MAP is set and the 

creating process is an execute-only process. This is the only other 

way to create an execute-only process besides using the GET JSYS on a 
virgin process. 
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The KFORK monitor call can be used to kill one or more processes 

CFORK ERROR MNEMONICS: 

FRKHX6: All relative process handles in use 

FRKHX8: Illegal to manipulate an execute-only process 

CFRKX3: Insufficient system resources 
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(CHFDB) 

CHFDB JSYS 64 



Changes certain words in the file descriptor block (FDB) for the 
specified file. (Refer to Section 2.2.8 for the format of this 
block.) 

ACCEPTS IN AC1: BO (CF%NUD) do not wait for the disk copy of the 

directory to be updated. 

The specified changes are made to the 
directory in memory and are written to the 
disk as a part of the normal monitor disk 
updating procedure. (See below for more 
information. ) 



B9-B17 
(CF%DSP) 

B18-B35 
(CF%JFN) 



index into FDB indicating word to be 
changed 

JFN (for a disk file) 



AC2 



AC3 



mask indicating bits to be changed. If changing a 
count value (in AC3) , use -1 as a mask. 

new values for changed bits. These values must be 
given in the bit positions corresponding to the mask 
given in AC2. 



RETURNS 



+1: always 



Because each CHFDB call changes only one word in the FDB, several 
calls must be executed to change several words. Each call causes disk 
I/O. And to keep this I/O to a minimum, the program should set bit 
CF%NUD on each call. The setting of this bit on each call permits the 
program to run faster by allowing several changes to be made to the 
FDB with minimum disk I/O. 

To ensure that all the changes have been written to the disk, the 
program can issue the last CHFDB call with bit CF%NUD off. Also, if 
the program requires the FDB on the disk to be updated after each 
call, it should execute each CHFDB call with bit CF%NUD off. 

There are a variety of calls used in manipulating the FDB; see the 
description of the FDB in Chapter 2 for information on these calls. 

Generates an illegal instruction interrupt on error conditions below. 

CHFDB ERROR MNEMONICS: 



CFDBX1 
CFDBX2 
CFDBX3 



Invalid displacement 

Illegal to change specified bits 

Write or owner access required 
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CFDBX4 

DE'SXl 

DESX3 

DESX4 

DESX7 



Invalid value for specified bits 

Invalid source/destination designator 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 
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CHKAC JSYS 521 



Checks if a user is allowed access to files in a given directory. 

This monitor call determines if the user can access files that have a 

specified protection code if the user is logged in with the given 
capabilities and connected to the directory. 



RESTRICTIONS: 

ACCEPTS IN AC1: 

AC2: 

RETURNS +1: 

+ 2: 



When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

length of the argument block in the right half. If 
B0(CK%JFN) is on, word .CKAUD of the argument block 
contains a JFN. 



address of argument block 

failure, error code in AC1 

success, access check is completed, with AC1 
containing -1 if access is allowed or if access is 
not allowed. 

The format of the argument block is as follows: 

Word Symbol Meaning 

.CKAAC Code of desired access to files. 

1 . CKALD Byte pointer to user name string, or 36-bit 

user number of user whose access is being 
checked . 



CKACD 



.CKAEC 



.CKAUD 



.CKAPR 



Byte pointer to directory name string (with 
punctuation), or 36-bit directory number to 
which user whose access is being checked is 
connected . 

Enabled capabilities of user whose access is 
being checked. (Refer to Section 2.7.1.) 

Byte pointer to directory name string (with 
punctuation) , or 36-bit directory number of 
the directory containing the files being 
accessed. If BO (CK%JFN) of AC1 is on, this 
word contains a JFN for the file being 
accessed . 

Protection of the files being accessed. 
(Refer to Section 2.2.6.) This word is not 
required if a JFN is supplied in word .CKAUD. 



Access codes are as follows 






.CKARD 


1 


.CKAWR 


2 


.CKAEX 


3 


.CKAAP 


4 


.CKADL 


6 


.CKADR 


10 


.CKACN 


11 


.CKACF 



read existing files 

write existing files 

execute existing files 

append to existing files 

obtain directory listing of existing files 

read the directory 

connect to the directory 

create files in the directory 



TOPS-20 Version 5 



3-45 



April 1982 



TOPS-20 MONITOR CALLS 
(CHKAC) 



CHKAC ERROR MNEMONICS 



CKAX1 
CKAX2 
CKAX3 
CKAX4 



Argument block too small 
Invalid directory number 
Invalid access code 
File is not on disk 
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(CIS) 

CIS JSYS 141 

Clears the software interrupt system for the current process. Clears 
all interrupts in progress and all waiting interrupts. 

RETURNS +1: always 
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(CLOSF) 

CLOSF JSYS 22 



Closes a specific file or all files. 

ACCEPTS IN AC1: B0(CO%NRJ) do not release the JFN. 

B6(CZ%ABT) abort any output operations currently 
being done. Close the file but do not 
perform any cleanup operations normally 
associated with closing a file. (If 
output is to a magnetic tape, for example, 
do not output remaining buffers or write 
tape marks. If output is to a disk file, 
do not change the end-of-file pointer.) If 
output is to a new disk file that has not 
been closed (and is therefore 
nonexistent) , the file is closed and then 
expunged . 

B7(CZ%NUD) do not update the copy of the directory on 
the disk. (Refer to CF%NUD of the CHFDB 
call description for further information.) 



B18-B35 
(CO%JFN' 



JFN of the file being closed 



RETURNS 



+ 1: 
4-2 



failure, error code in AC1 
success 



If AC1 contains -1, all files (and all JFNs) at or below this process 
(with the exception of the primary I/O files and files that cannot be 
closed by this process) are closed. This action is identical to that 
taken on a CLZFF call with AC1 containing the process handle .FHSLF 
(400000) . 

The OPENF monitor call can be used to open a specific file. 

CLOSF ERROR MNEMONICS: 

DESXl: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

CLSX1: File is not open 

CLSX2: File cannot be closed by this process 

CLSX3: File still mapped 

CLSX4: Device still active 
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ENQX20: Locked JFN cannot be closed 

10X11: Quota exceeded 

10X34: Disk full 

10X35: Unable to allocate disk - structure damaged 

All output errors can occur. 
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(CLZFF) 

CLZFF JSYS 34 

Closes process 1 files. Closes all files and/or releases all JFNs at 
and/or below a specified process. 

ACCEPTS IN AC1: B0(CZ%NIF) do not close files of inferior. 

processes 

B1(CZ%NSF) do not close files of this process. 

B2(CZ%NRJ) do not release JFNs. 

B3(CZ%NCL) do not close any files; only release 
nonopen JFNs 

B4(CZ%UNR) unrestrict files opened with restricted 
access for specified process. The 
specified process must be the same as, 
or inferior to, the process executing 
the call. 

B5(CZ%ARJ) wait until file can be closed, then 
close it, and release JFNs. 

B6(CZ%ABT) abort any output operations currently 
being done. Close the file but do not 
perforin any cleanup operations normally 
associated with closing a file (for 
example, do not output remaining buffers 
or write tape marks if output to a 
magnetic tape is aborted). If output to 
a new disk file that has not been closed 
(file is nonexistent) is aborted, the 
file is closed and then expunged. 

B7(CZ%NUD) do not update the copy of the directory 
on the disk. (Refer to CF%NUD of the 
CHFDB call description for further 
information. ) 

B18-B35 process handle 
(CZ%PRH) 

RETURNS +1: always. No action is taken if the call is in any 

way illegal. 

If AC1 contains only the process handle .FHSLF, the action is 
identical to that taken on a CLOSF call with AC1 containing -1. 

Generates an illegal instruction interrupt on error conditions below. 

CLZFF ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 
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FRKHX3: Invalid use of multiple process handle 

10X11: Quota exceeded 

10X34: Disk full 

10X35: Unable to allocate disk - structure damaged 
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(COMND) 

COMND JSYS 544 

Parses one field of a command that is either typed by a user or 
contained in a file. When this monitor call is used to read a command 
from a terminal, it provides the following features: 

1. Allows the input of a command (including the guide words) to 
be given in abbreviated, recognition (ESC and CTRL/F) , and/or 
full input mode. 

2. Allows the user to edit his input with the DELETE, CTRL/U, 
CTRL/W, and CTRL/R editing keys. 

3. Allows fields of the command to be defaulted if an ESC or 
CTRL/F is typed at the beginning of any field, or if a field 
is omitted entirely. 

4. Allows a help message to be given if a question mark (?) is 
typed at the beginning of any field. 

5. Allows input of an indirect file (@file) that contains the 
fields for all or the remainder of the command. 

6. Allows a recall of the correct portion of the last command 
(up to the beginning of the field where an error was 
detected) if the next command line begins with CTRL/H. The 
correct portion of the command is retyped, and the user can 
then continue typing from that point. 

7. Allows input of a line to be continued onto the next line if 
the user types a hyphen (-) immediately preceding a carriage 
return. (The carriage return is invisible to the program 
executing the COMND call, although it is stored in the text 
buffer.) The user can type the hyphen while he is typing a 
comment. The comment is then continued onto the next line. 

A hyphen not immediately followed by a carriage return is 
parsed as ordinary text. 

The COMND call allows comments in the command line. A command line 
can contain a comment if the field before the comment has been 
terminated and the comment is preceded by an exclamation point or a 
semicolon. If the comment starts with an exclamation point, COMND 
ignores all text between the exclamation point and either the end of 
the line or the next exclamation point. If the comment starts with a 
semicolon, COMND ignores all text on the remainder of the line. 

A command line can contain the name of an indirect command file so 
long as the file name comes at the beginning of a field. It must, 
however, be the last item on the line, and its contents must complete 
the command. The user must follow the name of the indirect command 
file (after any recognition is performed) with a carriage return. 

If a carriage return does not end the command line immediately after 
the name of the indirect command file, the system outputs the message 
?INDIRECT FILE NOT CONFIRMED. Also, if the user types a question mark 
(instead of the file specification of the indirect file) after he 
types the at-sign (@) character, the message FILESPEC OF INDIRECT FILE 
is output. 
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If the indirect file itself contains an ESC or a carriage return, 

COMND treats them as spaces. COMND places the contents of the 

indirect file in the text buffer, but does not display them on the 
user ' s terminal . 

As the user types his command, the characters are placed in a command 
text buffer. This buffer can also include the command line prompt. 
Several byte pointers and counts reflect the current state of the 
parsing of the command. These pointers and counts are as follows: 

1. Byte pointer to the beginning of the prompting-text buffer 

(.CMRTY). This pointer is also called the CTRL/R buffer byte 
pointer, since a CTRL/R causes COMND to redisplay the prompt 
contained in this buffer, along with anything the user typed 
on the command line before he typed the CTRL/R. 

The buffer that contains the prompt need not be contiguous 
with the buffer containing the remainder of the command line. 

2. Byte pointer to the beginning of the buffer that contains the 
user's input (.CMBFP). This is the limit back to which the 
user can edit. 

3. Byte pointer to the beginning of the next field of the 
command line to be parsed (.CMPTR). 

4. Count of the space remaining in the text input buffer 

(.CMCNT) . 

5. Count of the number of characters in the buffer that have not 
yet been parsed (.CMINC). 

The illustration below is a logical arrangement of the byte pointers 
and counts. Remember that the prompting text buffer need not be 
adjacent to the text buffer. 

.CMCNT 



. CMRTY 



.CMBFP 



CMINC 



.CMPTR 



These byte pointers and other information are contained in a command 
state block whose address is given as an argument to the COMND monitor 
call. The .CMINI function initializes these pointers. 
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COMND Parses a command line field by field. COMND substitutes default 
values for missing fields in the command line when the user types a 
carriage return, ESC, CTRL/F, or question mark. These characters are 
called action characters because they cause the system to act on the 
command as typed so far. Other characters that terminate a field are 
space, tab, slash, comma, and any other nonalphanumer ic character. 

Normally, parsing does not begin, and the COMND call does not return 

control to the program, until an action character is typed. But if 

B8(CM%WKF) is on in word .CMFLG when the COMND call executes, parsing 
begins after each field is terminated. 

A program parses a command line by repeated COMND calls. Each call 
specifies the type of field the program expects to be parsed. The 
program supplies this information, placing a function code and any 
data needed for the function in a function descriptor block. On 
successful completion of each call, the byte pointers and counts are 
updated in the command state block, and any data obtained for the 
field is returned. 

The program executing the COMND call should not reset the byte 
pointers in the command state block after it completes parsing a 
command line. It should set up the command state block before it 
begins to parse any commands, and then use the .CMINI function to 
initialize the command state block before parsing each command line. 
This allows the .CMINI function to use the CTRL/H error-recovery 
feature. 

If the program resets the pointers and counts in the command state 
block, instead of using the .CMINI function to do so, use of the 
CTRL/H feature is not possible. When a CTRL/H is typed, the .CMINI 
function allows recovery from an error in the last command only if the 
following are both true: 

1. The pointer to the beginning of the user's input (.CMBFP) and 
the pointer to the beginning of the next field to be parsed 
(.CMPTR) are not equal. 

2. The last character parsed in the previous command is not an 
end-of-line character. 

The COMND call allows the user to delete his typed input with the 
DELETE, CTRL/W, and CTRL/U keys without regard to field boundaries. 
When the user deletes part of a field that has already been parsed, 
the COMND call returns to the program with B3(CM%RPT) set in word 
.CMFLG, or the program resumes execution at the reparse address 
contained in word .CMFLG of the command state block. This address 
should be the place in the program at which parsing of the command 
line begins. If this address is zero, the program must test AC1 for 
this bit, and reparse the command line from the beginning, if 
necessary. (See the description of word .CMFLG of the command state 
block. ) 
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The calling sequence to the COMND call is as follows: 
ACCEPTS IN AC1: address of the command state block 



RETURNS 



AC2: 



+ 1: 



address of the first alternative function descriptor 
block 



always (unless a reparse is needed 

of .CMFLG is nonzero), with 

AC1 containing flags in the left h 

of the command state block 

The flags are copied from wo 

command state block. 

AC2 containing either the data obt 

or a monitor call error code 

not be parsed (CM%NOP is on in 

AC3 containing in the left half th 

function descriptor block giv 

in the right half the address 

descriptor block actually u 

contents of the right half u 

the type of atom that was pars 



and the right half 

alf and the address 

in the right half. 

rd .CMFLG in the 

ained for the field 

if the field could 

AC1) . 

e address of the 

en in the call , and 

of the function 

sed . Note that the 

niquely identifies 

ed. 



The format of the command state block is shown below. 



CMFLG 
CMIOJ 
CMRTY 
,CMBFP 
.CMPTR 
.CMCNT 
.CMINC 
,CMABP 
.CMABC 
.CMGJB 






17 18 3 5 


Flag Bits ! Reparse Dispatch Address 


Input JFN ! Output JFN 


Byte Pointer to CTRL/R Text 


Byte Pointer to Start of Text Buffer 


Byte Pointer to Next Input To Be Parsed 


Count of Space Left in Buffer 


Count of Unparsed Characters in Buffer 


Byte Pointer to Atom Buffer 


Size of Atom Buffer 


Address of GTJFN Argument Block 
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Command State Block 



Word Symbol Meaning 

.CMFLG Flag bits in the left half, and the reparse 

dispatch address in the right half. Some flag 
bits can be set by the program executing the COMND 
call; others can be set by the COMND call after 
its execution. The bits that can be set by the 
program are described following the Command State 
Block description. 

The reparse dispatch address is the location to 
which control is transferred when a reparse of the 
command is needed. This happens when a user edits 
characters in a field that was already parsed. 

If this field is zero, the COMND call sets 
B3(CM%RPT) in the left half of this word, and 
gives the +1 return when a reparse is needed. The 
program must then test the left half of AC1 to see 
if CM%RPT is set. If it is, the user must reenter 
the code that parses the first field of the 
command . 

The code at the reparse dispatch address should 
initialize the program's state to what it was 
after the last .CMINI function. This 
initialization should include resetting the stack 
pointer, closing and releasing any JFNs acquired 
since the last .CMINI function, and transferring 
control to the code immediately following the last 
.CMINI function call. 

1 .CMIOJ Input JFN in the left half, and output JFN in the 

right half. These designators identify the source 
for the input of the command and the destination 
for the output of the typescript. These 
designators are usually .PRIIN (for input) and 
.PRIOU (for output) . 

2 .CMRTY Byte pointer to the beginning of the prompting 

text . 

3 .CMBFP Byte pointer to the beginning of the user's input. 

The user cannot edit back past this pointer. 

4 .CMPTR Byte pointer to the beginning of the next field to 

be parsed. 

5 . CMCNT Count of the space remaining in the buffer after 

the .CMPTR pointer. 

6 .CMINC Count of the number of unparsed characters in the 

buffer after the .CMPTR pointer. 

7 .CMABP Byte pointer to the atom buffer, a temporary 

storage buffer that contains the last field parsed 
by the COMND call. The terminator of the field is 
not placed in this buffer. The atom buffer is 
terminated with a null. 
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Word 
10 

11 



Symbol 
.CMABC 

.CMGJB 



Meaning 



The size of the atom buffer in bytes. The atom 
buffer should be at least as large as the largest 
field the program must parse. 

Address of a GTJFN argument block. This block 
must be at least 16 (octal) words long and must be 
writable. If a longer GTJFN block is being 
reserved, the count in the right half of word 
.GJF2 of the GTJFN argument block must be greater 
than four. 

The GTJFN block is filled in by the COMND call 
with arguments for the GTJFN call if the specified 
COMND function requests a JFN (functions .CMIFI, 
.CMOFI, and .CMFIL). The user should store data 
in this block on the .CMFIL function only. 

The flag bits that can be set by the user in the left half of word 
.CMFLG in the Command State Block are described below. These bits 
apply to the parsing of the entire command and are preserved by COMND 
after execution. See the end of the COMND JSYS discussion for the 
bits that are returned by COMND in the left half of word .CMFLG. 



Bit 


Symbol 


6 


CM%RAI 


7 


CM%XIF 



CM%WKF 



Bits Supplied in State Block on COMND Call 



Meaning 

Convert lowercase input to uppercase. 

Do not recognize the at-sign (@) character as 
designating an indirect file; instead 
consider the character as ordinary 
punctuation. A program sets this bit. to 
prevent the input of an indirect file. 

Begin parsing after each field is terminated 
instead of only after an action character 
(carriage return, ESC, CTRL/F , question mark) 
is typed. A program sets this bit if it must 
change terminal characteristics in the middle 
of a command. Turning off echoing during the 
input of a password is an example of a use 
for this bit. 

Use of this bit is not recommended, however, 
because terminal wakeup occurs after each 
field is terminated, thereby increasing 
system overhead. 

The recommended method of changing terminal 
characteristics within a command is to input 
the field requiring the special 
characteristic on the next line with its own 
prompt. For example, if a program is 
accepting a password, it should turn off 
echoing after the .CMCFM function of the main 
command and perform the .CMINI function to 
type the prompt requesting a password on the 
next line. 
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The format of the function descriptor block is shown below. 



CMFNP 
CMDAT 
CMHLP 
■CMDEF 
CMBRK 






8 9 17 18 35 


! function 
! code 


! function ! address of next function 
! flags ! descriptor block 


! Data for specific function 


! By 


te pointer to help text for field 


! Byte 


pointer to default string for field 


! Addressof 4 -word break mask 

i 



Function Descriptor Block 



Word 




Symbol 
.CMFNP 



Meaning 



Function code and 
descriptor block. 



pointer to next 



function 



B0-B8 (CM%FNC) 
B9-B17 (CM%FFL) 
B18-B35(CM%LST) 



Function code 

Function-specific flags 

Address of the next function 

descriptor block, or zero if this 

is the last function descriptor 

block . 



1 .CMDAT Data for the specific function, if any. 

2 .CMHLP Byte pointer to the help text for this field. 

This word can be zero if the program is not 
supplying its own help text. CM%HPP must be set 
(in word 0) in order for this pointer to be used. 

3 .CMDEF Byte pointer to the default string for this field. 

This word can be zero if the program is not 
supplying its own default string. CM%DPP must be 
on in word in order for this pointer to be used. 

4 .CMBRK Address of a 4-word break mask that specifies 

which characters terminate a field. Word .CMBRK 
is ignored unless CM%BRK (B13) is on in word of 
the function descriptor block.. 

The individual words in the function descriptor block are described in 
the following paragraphs. 
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Words .CMFNP and .CMDAT of the function descriptor block 

Word .CMFNP contains the function code for the field to be parsed, and 
word .CMDAT contains any additional data needed for that function. 
The function codes, along with any required data for the functions, 
are described below. 

Code Symbol Meaning 

.CMKEY Parse a keyword, such as a command name. Word 

.CMDAT contains the address of a keyword symbol 
table. The keyword table must be in alphabetical 
order. See the TBLUK monitor call description for 
more information on the format of the keyword 
table . 

The table entries point to argument blocks. The 
right half of the first word of each such block 
contains the following bits, which can be set when 
B0-B6 of that first word are off and B7 (CM%FW) is 
set : 

B35(CM%INV) Suppress this keyword in the list 
output on a question-mark (?) . The 
program can set this bit to include 
entries in the table that should be 
output as part of the help text 
because they are not preferred 
keywords. This bit . is also used 
with the CM%ABR bit to prevent an 
abbreviation from being output when 
a question mark (?) is typed. 

This bit can be set, for example, 
to allow the keyword LIST to be 
valid, even though the preferred 
keyword may be PRINT. The LIST 
keyword is not listed in the output- 
given when a question mark (?) is 
typed . 

B34(CM%NOR) Do not recognize this keyword even 
if an exact match is typed by the 
user and suppress its listing in 
the list output when a question 
mark (?) is typed. (Refer to the 
TBLUK call description for more 
information on using this bit.) 
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Code Symbol Meaning 

.0 .CMKEY B33(CM%ABR) Consider this keyword a valid 
(Cont.) abbreviation for another entry in 

the table. The right half of this 
table entry points to the command 
table entry of the keyword for 
which this is an abbreviation. The 
program can set this bit to include 
entries in the table that are less 
than the minimum unique 
abbreviation. 

For example, this bit can be set to 
include the entry ST (for START) in 
the table. If the user then types 
ST as a keyword, COMND accepts it 
as a valid abbreviation for START 
even though there may be other 
keywords beginning with ST. 

To suppress the output of this 
abbreviation in the list of 
keywords output when a question 
mark (?) is typed, the program must 
also set the CM%INV bit. 

On a successful return, AC2 contains the address 
of the table entry where the keyword was found. 

Note that keywords in the table that contain 
trailing spaces (such as FORTRAN literals) are not 
recognized . 

1 .CMNUM Parse a number. Word .CMDAT contains the radix 

(from 2 to 10) of the number. On a successful 
return, AC2 contains the number. 

2 .CMNOI Parse a guide word string, but do not return an 

error if no guide word is input. Guide words are 
output if the user terminated the previous field 
with ESC. Guide words are not output, nor can 
they be input, if the user has caused parsing into 
the next field. 

For COMND to input a guide word, the guide word 
field must be delimited by parentheses. Word 
.CMDAT contains a byte pointer to an ASCIZ string 
that contains the guide word. This string does 
not contain parentheses. 

An error is returned only if a guide word is input 
that does not match the one expected by the COMND 
call. 
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Meaning 

Parse a switch. A switch field must begin with a 
slash, and can end with a colon or any legal field 
terminator . 

Word . CMDAT contains the address of a switch 
keyword symbol table. (Refer to the TBLUK monitor 
call description for the format of the table.) 
Switch entries in the keyword table must not 
contain a slash. If switch requires a value, 
however, its entry must end with a colon. 

The data bits CM%INV, CM%NOR, and CM%ABR, defined 
for the .CMKEY function, can also be set on this 
function. 

On a successful return, AC2 contains the address 
of the table entry where the switch keyword was 
found . 

Parse an input file specification. This function 
causes the COMND call to execute a GTJFN call, 
which attempts to parse the specification for an 
existing file using no default fields. Hyphens in 
the file specification are treated as alphanumeric 
characters . 

The .CMGJB address (word 11 in the command state 
block) must be supplied, but the GTJFN block 
should be empty. Data stored in the GTJFN block 
is overwritten by the COMND JSYS, and GTJFN flags 
are set in the GTJFN block. 

On a successful return, AC2 contains the JFN 
assigned . 

See note following .CMFIL function. 



CMOFI 



Parse an output file specificatio 
causes the COMND call to exec 
which parses the specification fo 
an existing file. The default 
is the generation number of the e 
1. The .CMGJB address must be 
GTJFN block should be empty. (Da 
block will be overwritten by 
Also, certain GTJFN flags are 
successful return, AC2 contains 
Hyphens are treated as alphanumer 
this function. 



n. This function 
ute a GTJFN call, 
r either a new or 
generation number 
xisting file plus 
supplied, but the 
ta stored in the 
the COMND JSYS. 
set . ) On a 
the JFN assigned, 
ic characters for 



See note following .CMFIL function. 



3-61 



TOPS-20 MONITOR CALLS 
(COMND) 



Code 

6 



Symbol Meaning 

.CMFIL Parse a general (arbitrary) file specification. 
This function causes the COMND call to execute a 
GTJFN to attempt to parse the specification for 
the file. The .CMGJB address must be supplied, 
but data stored in certain words of the GTJFN 
block is overwritten by the COMND JSYS and certain 
GTJFN flags are set (see note below) . On a 
successful return, AC2 contains the JFN assigned. 
Hyphens are treated as alphanumeric characters for 
this function. 

Note that portions of the GTJFN block used by 
functions .CMOFI, .CMIFI, and .CMFIL are 
controlled by COMND. The following list shows 
which words are under the control of COMND and 
which words are under the control of the user: 



GTJFN 
Word (s) 

.GJGEN 



Controlled 
by 

COMND 



Characteristics 



.CMOFI sets flags GJ%FOU, 
GJ%MSG, and GJ%XTN and 
clears all other flags. 

.CMIFI sets flags GJ%OLD, 
and GJ%XTN and clears all 
other flags. 

.GMOFI and .GMIFI zero 
the right half of word 
.GJGEN. 

.CMFIL sets flag GJ%XTN 
and clears GJ%CFM. 



GJSRC 

GJDEV 
GJJFN 



COMND 



COMND/ 
USER 



None 



Functions .CMIFI AND 
.CMOFI give COMND control 
of these words. .CMFIL 
gives the user control of 
these words. 



GJF2 - 




GJBFP 


COMND 


GJATR 


USER 



None 

Function .CMFIL gives the 
user control of this 
word. .GJATR is not used 
for other functions. 
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7 .CMFLD Parse an arbitrary field. This function is useful 

for fields not normally handled by the COMND call. 
The input, as delimited by the first 
nonalphanumer ic character, is copied into the atom 
buffer; the delimiter is not copied. Note the 
following : 

1. This function will parse a null field 

2. Hyphens are treated as alphanumeric characters 
for this function 

3. No validation is performed (such as filename 
validation) 

4. No standard help message is available (see 
description of word .CMHLP, below) 

5. The FLDBK. and BRMSK . macros can be used for 
including other characters in the field (such 
as the asterisk (*) character) 

10 .CMCFM Confirm. This function waits for the user to 

confirm the command with a carriage return and 
should be used at. the end of parsing a command 
1 ine. 

11 .CMDIR Parse a directory name. Login and files-only 

directories are allowed. Word .CMDAT contains 
data bits for this function. The currently 
defined bit is as follows: 

B0(CM%DWC) Allow wildcard characters to be 
typed in a directory name. 

On a successful return, AC2 
contains the 36-bit directory 
number . 

12 .CMUSR Parse a user name. Only login directories are 

allowed. On a successful return, AC2 contains the 
36-bit user number. 

13 .CMCMA Parse a comma. This function sets Bl (CM%NOP-no 

parse) in word .CMFLG of the command state block 
and returns an error if a comma is not the next 
item in the input. Blanks can appear on either 
side of the comma. This function is useful for 
parsing a list of arguments. 
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14 .CMINI Initialize the command line by setting up internal 

monitor pointers, typing the prompt, and checking 
to see if the user typed CTRL/H. This function 
should be used before beginning of parsing a 
command line, but not before reparsing a line. 
Reinitializing the command line with this function 
before starting to reparse the command line 
prevents the use of the CTRL/H feature. 

To use this function, the user first moves the 
needed data into the command state block and then 
issues .CMINI. If an error occurs while a line is 
being parsed, .CMINI is issued again by the COMND 
JSYS to reinitialize the line. 

For the second and all subsequent .CMINI function 
calls for a given line, the user should not alter 
the byte pointers and character counts in the 
command state block. To do so would disable the 
CTRL/H feature. This feature allows the user 
program, on parsing a bad atom, to print an error 
message, reissue the prompt, and parse the command 
line again without forcing the user to retype the 
entire line. 

If .CMINI reads a CTRL/H character, .CMINI resets 
all byte pointers and character counts except the 
.CMINC count to their original state. .CMINI sets 
the .CMINC count to the number of characters in 
the buffer up to the bad atom. These characters 
are output to the terminal and parsed again. 
Control then passes to the reparse address (if 
provided), and normal parsing resumes. The effect 
on the program is as if the bad atom had never 
been typed. 

15 .CMFLT Parse a floating-point number. On a successful 

return, AC2 contains the floating-point number. 

16 .CMDEV Parse a device name. A device name consists of up 

to six alphanumeric characters terminated by a 
colon (":"). On a successful return, AC2 contains 
the device designator. 

17 .CMTXT Parse the input text up to the next carriage 

return, place the text in the atom buffer, and 
return. If an ESC or CTRL/F is typed, it causes 
the terminal bell to ring (because recognition is 
not available with this function) and is otherwise 
ignored. If a question mark (?) is typed, an 
appropriate response is given, and the question 
mark (?) is not included in the atom buffer. (A 
question mark can be included in the input text if 
it is preceded by a CTRL/V. ) 
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20 .CMTAD Parse a date and/or time field according to the 

setting of bits CM%IDA and CM%ITM. The user must 
input the field as requested. Any date format 
allowed by the IDTIM call can be input. If a date 
is not input, it is assumed to be the current 
date. If a time is not input, it is assumed to be 
00:00:01. When both the date and time fields are 
input, they must be separated by one or more 
spaces. If the fields are input separately, they 
must be terminated with a space or carriage 
return. Word .CMDAT contains bits in the left 
half and an address in the right half as data for 
the function. The bits are: 

B0(CM%IDA) Parse a date 
B1(CM%ITM) Parse a time 
B2(CM%NCI) Do not convert the date and/or time to 

internal format. (Refer to Section 

2.9.2. ) 

The address in the right half is the beginning of 
a three-word block in the caller's address space. 
On a successful return, this block contains data 
returned from the IDTNC call executed by COMND if 
B2(CM%NCI) was on in the COMND call (if the input 
date and/or time field was not to be converted to 
internal format). If B2(CM%NCI) was off in the 
COMND call, on a successful return, AC2 contains 
the internal date and time format. 

21 .CMQST Parse a quoted string up to the terminating quote. 

The delimiters for the string must be double 
quotation marks and are not copied to the atom 
buffer. A double quotation mark is input as part 
of the string if two double quotation marks appear 
together. This function is useful if the legal 
field terminators and the action characters are to 
be included as part of a string. The characters 
?, ESC, and CTRL/F are not treated as action 
characters, and are included in the string stored 
in the atom buffer. Carriage return is an invalid 
character in a quoted string and causes Bl (CM%NOP) 
to be set on return. 

22 .CMUQS Parse an unquoted string up to one of the 

specified break characters. Word .CMDAT contains 
the address of a 4-word block of 128 break 
character mask bits. (Refer to word .RDBRK of the 
TEXTI call description for an explanation of the 
mask.) The characters scanned are not placed in 
the atom buffer. On return, .CMPTP is pointing to 
the break character. This function is useful for 
parsing a string with an arbitrary delimiter. The 
characters ?, ESC, and CTRL/F are not treated as 
action characters (unless they are specified in 
the mask) and can be included in the string. 
Carriage return can also be included if it is not 
one of the specified break characters. 
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Code Symbol Meaning 

23 .CMTOK Parse the input and compare it with a given 

string. Word .CMDAT contains the byte pointer to 
the given string. This function sets Bl (CM%NOP) 
in word .CMFLG of the command state block and 
returns if the next input characters do not match 
the given string. Leading blanks in the input are 
ignored. This function is useful for parsing 
single or multiple character operators (e.g., + or 
* * ) . 

24 .CMNUX Parse a number and terminate on the first 

nonnumeric character. Word .CMDAT contains the 
radix (from 2 to 10) of the number. On a 
successful return, AC2 contains the number. This 
function is useful for parsing a number that may 
not be terminated with a nonalphabet ic character 
(e.g. , 100PRINT FILEA) . 

Note that nonnumeric identifiers can begin with a 
digit (for example, 1SMITH as a user name). When 
a nonnumeric identifier and a number appear as 
alternates for a field, the order of the function 
descriptor blocks is important. The .CMNUX 
function, if given first, would accept the digit 
in the nonnumeric identifier as a valid number 
instead of as the beginning character of a 
nonnumeric identifier. 

25 .CMACT Parse an account string. The input, as delimited 

by the first nonalphanumer ic character, is copied 
into the atom buffer; the delimiter is not 
copied. No verification is performed nor is any 
standard help message available. The length of 
the string is checked, and if it exceeds 39 
characters, an error is generated. 

26 . CMNOD Parse a network node name. A node name consists 

of up to six alphanumeric characters followed by 2 
colons ("::"). The node name must begin with an 
alphabetic character. Lowercase characters are 
converted to uppercase characters. The node name 
is copied into the atom buffer without the colons. 

In addition to the function code in bits 0-8 (CM%FNC) , .CMFNP also 
contains function-specific flag bits in bits 9-17 (CM%FFL) , and the 
address of another function descriptor block in bits 18-35 (CM%LST) . 
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The flag bits that can be set in bits 9-17 (CMIFFL) are as follows:: 
Bit Symbol Meaning 

12 CM%NSF Indicates that a suffix is optional. This bit is 

meaningful only with the .CMDEV and .CMNOD 
functions. If this bit is not set, the suffix is 
required . 

13 CM%BRK Notifies COMND that word .CMBRK of the function 

descriptor block contains a pointer to a 4-word 
break mask. See description of word .CMBRK for 
more details. 

14 CM%PO The field is to be parsed only, and the field's 

existence is not to be verified. This bit 
currently applies to the .CMDEV, .CMDIR, .CMNOD, 
and .CMUSR functions and is ignored for the 
remaining functions. On return, COMND sets 
Bl (CM%NOP-no parse) only if the field typed is not 
in the correct syntax. Also, data returned in AC2 
may not be correct. 

15 CM%HPP A byte pointer to a program-supplied help message 

for this field is given in word 2 (.CMHLP) of this 
function descriptor block. 

16 CM%DPP A byte pointer to a program-supplied default 

string for this field is given in word 3 (.CMDEF) 
of this function descriptor block. 

17 CM%SDH The output of the default help message is to be 

suppressed if the user types a question mark. 
(See below for the default messages.) 

The address of another function descriptor block can be given in bits 
18-35 (CM%LST) of the .CMFNP word. The use of this second descriptor 
block is described below. 

Usually one COMND call is executed for each field in the command. 
However, for some fields, more than one type of input may be possible 
(e.g., after a keyword field, the next field could be a switch or a 
filename field). In these cases, all the possibilities for a field 
must be tried in an order selected to test unambiguous cases first. 

When the COMND call cannot parse the field as indicated by the 
function code, it does one of two things: 

1. It sets the current pointer and counts such that the next 
call will attempt to parse the same input over again. It 
then returns with Bl (CM%NOP) set in the left half of the 
.CMFLG word in the command state block. The caller can then 
issue another COMND call with a function code indicating 
another of the possible fields. After the execution of each 
call, the caller should test the CM%NOP flag to see that the 
field was parsed successfully. 

2. If an address of another function descriptor block is given 
in CM%LST, the COMND call moves to this descriptor block 
automatically and attempts to parse the field as indicated by 
the function code contained in B0-B8 (CM%FNC) in word .CMFNP 
of that block. If the COMND call fails to parse the field 
using this new function code, it moves to a third descriptor 
block if one is given. This sequence continues until either 
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the field is successfully parsed or the end of the chain of 
function blocks is reached. Upon completion of the COMND 
call, AC3 contains the addresses of the first and last 
function blocks used. 

By specifying a chained list of function blocks, the program can have 
the COMND call automatically check all possible alternatives for a 
field and not have to issue a separate call for each one. In 
addition, if the user types a question mark, a list is output of all 
the alternatives for the field as indicated by the list of function 
descriptor blocks. 

Word .CMHLP of the function descriptor block 

This word contains a byte pointer to a program-supplied help text. 
The COMND call outputs this help if the user types a question mark 
when entering a command field. Bit 15(CM%HPP) must be set in word 
(.CMFNP) of the function descriptor block for this pointer to be used. 

If B17(CM%SDH) is set in this word, COMND outputs only the 
program-supplied message. If B17(CM%SDH) is not set, COMND appends 
the default help message to the program-supplied message, and outputs 
them both. 



If .CMHLP is zero, COMND outputs only the default message. 

The default help message depends on the particular function being used 
to parse the current field. The following table lists the default 
help message for each function available in the COMND call. 



Function 

.CMKEY (keyword) 



CMNUM (number) 



Default Help Messages 

Message 

one of the following 

followed by the alphabetical list of valid 
keywords. If the user types a question mark 
in the middle of the field, only the keywords 
that can possibly match the field as 
currently typed are output. If no keyword 
can possibly match the currently typed field, 
the following message is output: 



keyword (no defined keywords match this input) 



If there is only 1 keyword, the keyword 
becomes the HELP message. 

The help message output depends on the radix 
specified in .CMDAT in the descriptor block. 
If the radix is octal, the help message is 

octal number 
If the radix is decimal, the help message is 

decimal number 
If the radix is any other radix, the help 
message is 

a number in base nn 
where nn is the radix. 
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Function 

.CMNOI (guide word; 

.CMSWI (switch) 



.CMIFI (input file) 
.CMOFI (output file) 
.CMFIL (any file) 



Message 



None 



CMFLD (any field) 

CMCFM (confirm) 

CMDIR (directory) 

,CMUSR (user) 

, CMCMA (comma) 

CMINI (initialize) 

CMFLT (floating point) 

.CMDEV (device) 

CMTXT (text) 

,CMTAD (date) 



CMQST (quoted) 

CMUQS (unquoted) 

CMTOK (token) 

CMNUX (number) 

CMACT (account) 

CMNOD (node) 



one of the following 

followed by the alphabetical list of valid 
switch keywords. The same rules apply as for 
.CMKEY function, above. 

The help message output depends on the 
settings of certain bits in the GTJFN call. 
If bit GJ%OLD is off and bit GJ%FOU is on, 
the help message is 

output filespec 
Otherwise, the help message is 

input filespec 

None 

confirm with carriage return 

directory name 

user name 

comma 

None 

number 

device name 

text string 

The help message depends on the bits set in 
.CMDAT in the descriptor block. If CM%IDA is 
set, the help message is 

date 
If CM%ITM is set, the help message is 

t ime 
If both are set, the help message is 

date and time 

Quoted string 

Unquoted string if "?" is a break character, 
otherwise none 

None 

Same as .CMNUM 

None 

node name 



3-69 



TOPS-20 MONITOR CALLS 
(COMND) 

Word .CMDEF of the function descriptor block 

This word contains a byte pointer to the ASCIZ string to be used as 
the default for this field. For this pointer to be used, bit 16 
(CM%DPP) must be set in word (.CMFNP) of the descriptor block. The 
string is output to the destination, as well as copied to the text 
buffer, if the user types an ESC or CTRL/F as the first nonblank 
character in the field. If the user types a carriage return, the 
string is copied to the atom buffer, but is not output to the 
destination . 

When the caller supplies a list of function descriptor blocks, the 
byte pointer for the default string must be included in the first 
block. The CM%DPP bit and the pointer for the default string are 
ignored when they appear in subsequent blocks. However, the default 
string can be worded so that it applies to any of the alternative 
fields. The effect is the same as if the user had typed the given 
string. 

Defaults for fields of a file specification can also be supplied with 
the .CMFIL function. If both the byte pointer to the default string 
and the JFN defaults have been provided, the COMND default is used 
first, and then, if necessary, the GTJFN defaults are used. 

NOTE 

The function descriptor block, whose 
address is given in AC2, can be set up 
by the FLDDB. and FLDBK. macros defined 
in MACSYM. (See the end of the COMND 
section for a description of these 
macros . ) 

Word .CMBRK of the function descriptor block 

This word contains a pointer to a 4-word user-specified mask that 
determines which characters constitute end of field. The leftmost 32 
bits of each word correspond to a character in the ASCII collating 
sequence (in ascending order). If the bit is on for a given 
character, typing that character causes the COMND JSYS to treat the 
characters typed so far as a separate field and to parse them 
according to the function being used. CM%BRK (B13) must be on in the 
first word of the function descriptor block, or COMND ignores word 
.CMBRK. 

Ordinarily, the user relies on COMND ' s default masks (varying 
according to function) to specify which characters signal end of 
field, and thus is not concerned with word .CMBRK of the function 
block. But for special purposes such as allowing "*" or "%" to be 
part of a field, rather than a field delimiter, the user must specify 
his own mask. (In this example, the bits for "*" and "%" would be off 
in the mask word.) The user may inspect COMND ' s default masks (defined 
in MONSYM) for help in designing a custom mask. 
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The following is a list of the COMND functions that use masks 



Mask 




COMND 


Changeable 


Symbols 




Function 


by User 


KEYBO. - 


KEYB3. 


.CMKEY 


Yes 


DEVBO. - 


DEVB3. 


•CMDEV 


Yes (only 


FLDBO. - 


FLDB3. 


.CMFLD 


Yes 


EOLBO. - 


EOLB3. 


.CMTXT 


Yes 


KEYBO. - 


KEYB3. 


.CMSWI 


Yes 


User-specified 


•CMDAT 


Yes 


USRBO. - 


USRB3. 


.CMUSR 


No 


FILBO. - 


FILB3. 


.CMFIL 


No 


FILBO. - 


FILB3. 


•CMIFI 


No 


FILBO. - 


FILB3. 


.CMOFI 


No 


internal 




.CMNUM 


No 


FILBO. - 


FILB3. 


.CMDIR 


No 


internal 




.CMFLT 


No 


ACTBO. - 


ACTB3. 


.CMACT 


No 



COMND will ignore any break masks that 
that do not allow user-modified masks. 



are specified for functions 



Note that specifying a zero mask with CM%BRK set will cause 
line buffer to fill up and generate an error. 



the TTY 



On a successful return, the COMND call returns flag bits in the left 
half of AC1 and preserves the address of the command state block in 
the right half of AC1. These flag bits are copied from word .CMFLG in 
the command state block and are described as follows. 

Bits Returned on COMND Call 



Bit 


Symbol 





CM%ESC 


1 


CM%NOP 



Meaning 

An ESC was typed by the user as the terminator for 
this field. 

The field could not be parsed because it did not 
conform to the specified function(s). An error 
code is returned in AC2. If this bit is set, bits 
(CM%ESC) and 2 (CM%EOC) might not contain valid 
information. 



CM%EOC The field was terminated with a carriage return. 

CM%RPT Characters already parsed need to be reparsed 
because the user edited them. This bit does not 
need to be examined if the program has supplied a 
reparse dispatch address in the right half of 
.CMFLG in the command state block. 



CM%SWT A switch field was terminated with a colon. This 
bit is on if the user either used recognition on a 
switch that ends with a colon or typed a colon at 
the end of the switch. 



CM%PFE 



The previous field was terminated with an ESC. 
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When a field cannot be parsed, Bl (CM%NOP) is set in AC1, and one of 
the following error codes is returned in AC2. Note that if a list of 
function descriptor blocks is given and an error code is returned, the 
error is associated with the function that had the largest atom buffer 
after all function blocks have been tried without a successful parse 
of the field. 



NPXAMB 
NPXNSW 
NPXNOM 
NPXNUL 
NPXINW 
NPXNC: 
NPXICN 
NPXIDT 
NPXNQS 
NPXNMT 
NPXNMD 
NPXCMA 
C0MX18 
C0MX19 



ambiguous 

not a switch - does not begin with slash 
does not match switch or keyword 
null switch or keyword given 
invalid guide word 
not confirmed 

invalid character in number 
invalid device terminator 

not a quoted string - does not begin with double quote 
does not match token 

does not match directory or user name 
comma not given 

invalid character in node name 
too many characters in node name 

Macros 



Several macros (defined in MACSYM) are available to make using the 
COMND JSYS more convenient. These macros are as follows: 

FLDDB. (TYP,FLGS,DATA,HLPM,DEFM,LST) 

where : 

TYP = function type 
FLGS = function flags 
DATA = function-specific data 
HLPM = help message 
DEFM = default text 

LST = additional invocations of the FLDDB. macro (used only if 
multiple function blocks are required) 

This macro generates function descriptor blocks for COMND. For 
example, the following code performs a .CMINI function: 

MOVEI T1,STEBLK ;Get address of COMND state block 

MOVEI T2, [FLDDB. ( .CMINI) ] ;Get address of function block 
COMND 
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The following code performs a .CMKEY function (assuming that 
the keyword table started at address CMDTAB: 

MOVEI T1,STEBLK ;Get address of COMND state block 

MOVEI T2, [FLDDB( .CMKEY, <CM%DPP+CM%HPP> , CMDTAB, 

<help text>,<default text>)] 
COMND 

FLDBK. (TYP,FLGS,DATA,HLPM,DEFM,BRKADR,LST) 

This is exactly the same as FLDDB., except that a provision has 
been made for the address of the first word of a 4-word 
character mask (BRKADR) . This version is for use when a 
user-specified character mask is required. 

BRMSK. ( INI 0, INI 1, INI 2, INI. 3, ALLOW, DISALLOW) 

where : 

INIO = first word of character mask 
INI1 = second word of character mask 
INI2 = third word of character mask 
INI3 = fourth word of character mask 
ALLOW = characters to allow in the mask 
DISALLOW = characters to disallow in the mask 

This macro generates 4-word character masks for use with those 
COMND functions that allow the user to specify his own mask. 
For example, executing the following code allows "*" in the 
predefined mask for the .CMFLD function (FLDBO thru BLDB3): 

BRMSK. (FLDBO. ,FLDB1. ,FLDB2. ,FLDB3. ,<*>,) 

Also, the BRMSK. macro may be invoked within the FLDBK. macro: 

FLDBK. (TYP ir FLGS,DATA,HLPM,DEFM, [ 

BRMSK. (INIO, INI1,INI2,INI3, ALLOW, DISALLOW) ] ,LST) 

The COMND call causes other monitor calls to be executed, depending on 
the particular function that is requested. Failure of these calls 
usually results in the failure to parse the requested field. In these 
cases, the relevant error code can be obtained by the GETER and ERSTR 
monitor calls. 

Any TBLUK error can occur on the keyword and switch functions. 

Any NIN/NOUT and FLIN/FLOUT error can occur on the number 
functions . 

Any GTJFN error except for GJFX37 can occur on the file 
specification functions. 

Any IDTNC error can occur on the date/time function. 

Any RCDIR or RCUSR error can occur on the directory and user 
functions . 

Any STDEV error can occur on the device function. 



3-7 3 



TOPS-20 MONITOR CALLS 
(COMND) 



Generates an illegal instruction interrupt on error conditions below, 
COMND ERROR MNEMONICS: 



COMNX1 
COMNX2 
COMNX3 
COMNX5 
COMNX8 
COMNX9 
COMX10 
COMX11 
COMX12 
COMX13 
COMX14 
COMX15 
COMX16 
COMX17 
VACCX1 



Invalid COMND function code 

Field too long for internal buffer 

Command too long for internal buffer 

Invalid string pointer argument 

Number base out of range 2-10 

End of input file reached 

Invalid default string 

Invalid CMRTY pointer 

Invalid CMBFP pointer 

Invalid CMPTR pointer 

Invalid CMABP pointer 

Invalid default string pointer 

Invalid help message pointer 

Invalid byte pointer in function block 

Account string too long 
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CRDIR JSYS 240 

Creates, changes, or deletes a directory entry. 

RESTRICTIONS: some functions require WHEEL or OPERATOR capabilities 
enabled . 

ACCEPTS IN AC1: byte pointer to ASCIZ string containing the structure 
and directory name. The string must be of the form: 
structure: <directory>. 

AC2: B0(CD%LEN) set flags and length of the argument 

block from the values given in word 
.CDLEN. 

Bl (CD%PSW) set password from argument block 

B2 (CD%LIQ) set working disk storage limit from 
argument block 

B3 (CD%PRV) set capability bits from argument block 

B4 (CD%MOD) set mode bits from argument block 

B5(CD%LOQ) set permanent disk storage limit from 
argument block 

B6 (CD%NUM) set directory number from argument block 
(valid only when creating a directory) 

B7 (CD%FPT) set default file protection from argument 
block 

B8(CD%DPT) set directory protection from argument 
block 

B9 (CD%RET) set default retention count from argument 
block 

B:L0(CD%LLD) set last LOGIN date from argument block 

BI1(CD%UGP) set user groups from argument block 

B12(CD%DGP) set directory groups from argument block 

BI3(CD%SDQ) set subdirectory quota from argument 
block 

BI4(CD%CUG) set user groups assignable by this 
directory from argument block 

B15(CD%DAC) set default account from argument block 

B17(CD%DEL) delete this directory entry 

B18-B35 (CD%APB) address of the argument block 

AC3: byte pointer to ASCIZ string containing the password 
of the directory. This pointer is required when a 
nonpr ivileged user is changing parameters for his 
directory . 
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RETURNS +1: always, with directory number in AC1 

This monitor call requires the process to have WHEEL or OPERATOR 
capability enabled unless one of the following conditions is true: 

1. The specified directory is one to which the caller has owner 
access, and the caller is changing any one of the following 
parameters: 

password (.CDPSW) 
default file protection (.CDFPT) 
directory protection (.CDDPT) 
default retention count (.CDRET) 
default account (.CDDAC) 

This feature is installation dependent and is enabled by 
issuing function .SFCRD of the SMON monitor call. 

2. The specified directory is inferior to the one to which the 
caller is currently connected, and the caller has owner 
access to this inferior directory. 

Refer to Section 2.2.6 for the description of owner access. 

The format of the argument block is as follows: 

Word Symbol Meaning 

.CDLEN flag bits in the left half, and length of the 

argument block in the right half. The 
following bits are defined: 

B0(CD%NSQ) When restoring this directory, do 
not update its superior directo- 
ry's quotas (permanent, working, 
and subdirectory quotas) to 
account for this directory. If 
this bit is off, the superior di- 
rectory's quotas are updated. 
This bit is set by the DLUSER or 
DUMPER program to retain the 
superior directory's quotas when 
restoring its subdirectories. 
The process must have WHEEL or 
OPERATOR capability enabled to 
set this bit. 

Bl (CD%NCE) When restoring or reconstructing 
this directory, do not change any 
directory parameters if the 
directory currently exists on 
disk; set the parameters only if 
the directory does not exist. If 
this bit is off, the directory 
parameters as saved are restored 
for the directory. This bit is 
set by the DLUSER or DUMPER 
program to restore or reconstruct 
directories from out-of-date 
files without causing existing 
directories to revert to older 
parameters. The process must 
have WHEEL or OPERATOR capability 
enabled to set this bit. 
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Word Symbol 

.CDLEN 
(Cont. ] 



.CDPSW 



.CDLIQ 



.CDPRV 



.CDMOD 



Meaning 

B2(CD%NED) Set default on-line expiration 
date from word .CDDNE. Currently 
not implemented. 

B3(CD%FED) Set default on-line expiration 
date from word .CDDFE. Currently 
not implemented. 

byte pointer to password string, which is a 
string from 1 to 39 alphanumeric characters 
(including hyphens). 

maximum number of pages that can be used for 
working disk storage (also known as logged-in 
quota) . 



capabilities for this user. (Refer 
Section 2.7.1 for the capability bits.) 

mode word. 



to 



BO (CD%DIR) 



Bl (CD%ANA) 



directory name can be used only 
to connect to (the directory is a 
files-only directory). If this 
bit is off, the directory name 
can be used for logging in and 
connecting to. 

accounts are alphanumeric. This 
bit is not used and is provided 
for compatibility with systems 
earlier than TOPS-20 version 3. 



5 .CDLOQ 



6 .CDNUM 



7 .CDFPT 



B2(CD%RLM) all messages from the file 
<SYSTEM>MAIL.TXT are repeated 
each time the user logs in. If 
this bit is off, only the 
messages not previously printed 
are output when the user logs in. 

B7 (CD%DAR) If on, this bit indicates that 
the file should be archived 
rather than migrated to virtual 
disk when the on-line expiration 
date has been reached. 

maximum number of pages that can be used for 
permanent disk storage (also known as 
logged-out quota) . 

directory number, valid only when creating a 
directory. An error code is returned if the 
user changes the number of an existing 
directory (CRDIX2) or gives a nonunique 
number (CRDIX8) . 



default file 
right-justified) 



protection 



(18 



bits , 
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Word Symbol 
10 .CDDPT 



11 



16 



17 



20 



20 



21 



CDRET 



12 


.CDLLD 


13 


.CDUGP 


14 


.CDDGP 


15 


.CDSDQ 



CDCUG 



CDDAC 



.CDDNE 



CDDNE 



CDDFE 
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Meaning 

directory protection 
r ight- just if ied) . 



(18 



bits , 



default number of generations of a file to be 
retained in the directory (retention count). 
Valid numbers are to 63, with being an 
infinite number. 

date of last login. 

address of user group list for this 
d irectory . 

address of directory group list. 

maximum number of directories that can be 
created inferior to this directory. This 
parameter allows a user to create directories 
with the BUILD command. 

address of user group list. This list 
contains the group numbers that can be 
assigned to subdirectories. 

byte pointer to default account string for 
this user. 

default on-line expiration date and time, 
which can be an explicit date and time 

(internal format) or an interval (in days). 
In either case, the specified date/interval 
cannot exceed the system maximum. This 
parameter is read if CD%NED (1B2) or CD%FED 

(1B3) in .CDLEN are set. If a new directory 
is created and this parameter is not 
specified, the system default is used. 

An unprivileged user can modify his defaults 

to be less than or equal to those that are 

currently specified or the system maximum, 
whichever is greater. 



This word is currently reserved and 
implemented . 



is 



not 



default off-line expunge date and time. 
Otherwise similar to .CDDNE (above). 



This word is currently reserved and 
implemented . 



is 



not 



The format of each group list is a table with the first word 
containing a count of the number of words (including the count word) 
in the table and each subsequent word containing a group number. 

When CRDIR is being executed to create a directory, bits 0-17 of AC2 
can optionally be on or off. If a particular bit is on, it indicates 
that the corresponding argument in the argument block should be 
examined. If the bit is off, it indicates that the argument should be 
defaulted . 
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The following table lists the bits and the corresponding argument 
defaults: 



Bits 



Argument Defaults 



B2 (CD%LIQ) maximum working disk file storage to 250 pages 

B3 (CD%PRV) no special capabilities 

B4 (CD%MOD) directory name that can be used for logging in and 

that lists the messages from <SYSTEM>MAIL.TXT only 

once 
B5(CD%LOQ) maximum permanent disk file storage to 250 pages 
B6(CD%NUM) the first unused directory number. B6 should 

normally be off. 
B7(CD%FPT) default file protection to 777700 
B8(CD%DPT) directory protection to 777700 
B9(CD%RET) default file retention count to 1 
B10(CD%LLD) never logged in 
B11(CD%UGP) no user groups 
B12(CD%DGP) no directory groups 

B13(CD%SDQ) no ability to create inferior directories 
B14 (CD%CUG) no assignable user groups for inferior directories 
B15(CD%DAC) no default account 

When CRDIR is being executed to change a directory and any of B0-B17 
of AC2 is off, the corresponding parameter is not affected. 

When CRDIR is being executed to delete a directory, the settings of 
B0-B17 of AC2 are ignored. A CRDIR call cannot be given to delete a 
directory that has directories inferior to it. 

The GTDIR call can be used to obtain the directory information. 

Generates an illegal instruction interrupt on error conditions below. 

CRDIR ERROR MNEMONICS: 

ACESX3: Password required 

CRDIX1: WHEEL or OPERATOR capability required 

CRDIX2: Illegal to change number of old directory 

CRDIX3: Insufficient system resources (Job Storage Block full) 

CRDIX4: Superior directory full 

CRDIX5: Directory name not given 

CRDIX6: Directory file is mapped 

CRDIX7: File(s) open in directory 

CRDIX8: Invalid directory number 

CRDIX9: Internal format of directory is incorrect 

CRDI10: Maximum directory number exceeded; index table needs 
expanding 

CRDIll: Invalid terminating bracket on directory 

CRDI12: Structure is not mounted 

CRDI13: Request exceeds superior directory working quota 

3-79 



TOPS-20 MONITOR CALLS 
(CRDIR) 



CRDI14 
CRDI15: 
CRDI16 
CRDI17 

CRDI18 
CRDI19 
CRDI20 
CRDI21 
CRDI22 
CRDI2 3 
CRDI24 



Request exceeds superior directory permanent quota 

Request exceeds superior directory subdirectory quota 

Invalid user group 

Illegal to create nonf iles-only subdirectory 
files-only directory 



under 



Illegal to delete logged-in directory 

Illegal to delete connected directory 

WHEEL, OPERATOR, or requested capability required 

Working space insufficient for current allocation 

Subdirectory quota insufficient for existing subdirectories 

Superior directory does not exist 

Invalid subdirectory quota 
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CRJOB JSYS 2 



Creates a new job and optionally logs it in. This monitor call causes 
the functions that are normally performed when a job is created (for 
example, assignment of a JSB, the primary I/O designators, and the job 
controlling terminal) to be performed for the new job. 



RESTRICTIONS 



ACCEPTS IN AC1 
AC2 
AC3 



RETURNS 



+ 1 
+ 2 



some functions require WHEEL or OPERATOR capabilities 
enabled . 

When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

flag bits, , 

address of argument block 

(optional) If CRJOB is to be used to release control 
over a job previously created with CRJOB (bit 17 in 
AC1 must be on) , then AC3 contains the job number of 
the previously-created job. 

failure, with error code in AC1 

success, with the number of the new job in AC1 



The flag bits defined in the left half of AC1 are as follows: 
Bit Symbol Meaning 

CJ%LOG Log in the new job.. If this bit is off, the new 

job is created but not logged in. 

1 CJ%NAM Set the user name and password from the argument 

block. If this bit is off, the user name of the 
caller is given to the new job. 

2-3 CJ%ACT Set the account of the new job to the following: 

Meaning 

Use current account of caller. 

Use account from the argument 
block . 

Use default account of user 
whose job is being created. 

CJ%ETF If set, place the TOPS-20 command processor in the 
top-level process of the new job. The command 
processor reads its program argument block (see 
below) at the time it is started. 

CJ%FIL and CJ%ETF interact in the following ways: 

1. If CJ%FIL is on and CJ%ETF is on, then a job 
is created with a top process consisting of 
the TOPS-20 command processor and an inferior 
process consisting of the file to which word 
.CJFIL points. 



Code 


Symbol 





.CJUCA 


1 


.CJUAA 


2 


.CJUDA 
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Bit Symbol Meaning 

4 CJ%ETF 2. IF CJ%FIL is off and CJIETF is on, then a job 

is created with a top process consisting of 
the TOPS-20 command processor. No inferior 
process is created. 

3. If CJ%FIL is on and CJ%ETF is off, then a job 
is created with a top process consisting of 
the file to which word .CJFIL points. No 
inferior process is created. 

The format of the program argument block is as 
follows: 

Word Contents 

Count of words in block, not including 
this word. 

1 1B0+3B6+2B12+CR%PRA - indicates this is 
a program argument block created by the 
CRJOB JSYS. 

2 1B0 + offsetl - offsetl is the offset in 
this block of the first argument being 
passed . 

3 1B0 + offset2 - offset2 is the offset in 
this block of the second argument being 
passed . 

n (offsetl) This argument is a copy of the 
flag bits from word 10 (.CJEXF) of the 
CRJOB argument block, which contains the 
flags for the command language 
processor . 

n+1 (offset2) This argument contains 
information about the process being 
started: the process handle in the left 
half, and the entry vector offset in the 
right half. The entry vector offset is 
from word . C JSVF (word 4) of the CRJOB 
argument block. 

The program argument block is created by the CRJOB 
monitor call and is passed to the process by a 
PRARG monitor call (performed internally by 
CRJOB) . The user does not specify any of the 
information in the program argument block. Only 
the program at the top fork level of the job 
(usually the TOPS-20 EXEC) can read the PRARG 
block . 
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Bit Symbol Meaning 

5 CJ%FIL Move the file to which a word in the argument 

block points into a process in the new job (by 
means of a GET call). If B4 (CJ%ETF) is off, the 
file is placed in the top-level process of the new 
job. If B4(CJ%ETF) is on, the file is placed in 
the process designated in the Command Language 
Processor's PPARG argument block (see below). 

If B5(CJ%FIL) is off, no file is moved into a 
process of the new job, and the top-level process 
of the new job is the Command Language Processor. 

6 CJ%ACS Load the ACs from the value in the argument block. 

The ACs are loaded only if a program other than 
the Command Language Processor is being run. 

7 CJ%OWN Maintain ownership of the new job. This means 

that the new job cannot be logged out until the 
caller releases ownership of it. If this bit is 
off, control of the new job is released. 

8 CJ%WTA Do not start the new job until it is attached 

(using ATACH JSYS) to a terminal. If this bit is 
off, the new job is started. 

9 CJ%NPW Do not check the password given when the new job 

is logged in. If this bit is off, the password is 
checked unless the new job is being logged in with 
the same user name as the caller, or with WHEEL or 
OPERATOR capability enabled. 

10 CJ%NUD Do not update the date of LOGIN for the user 

logging in to the new job. If this bit is off, 
the date of LOGIN is updated, unless the user is 
logging in with the same user name as the caller, 
or with WHEEL or OPERATOR capability enabled. 

11 CJ%SPJ Set (by means of a SPJFN call) the primary input 

and output designators from the argument block 
before starting the job. The primary I/O 
designators are not changed for a Command Language 
Processor in the top-level process of the new job; 
they are changed only for inferior processes. If 
this bit is off, the primary I/O designators of 
the new job are the job's controlling terminal. 

12 CJ%CAP Set the allowed user capabilities of the new job 

(right half) to be the same as the caller's 
currently enabled capabilities, until the new job 
is logged in. If this bit is off, the new job has 
the user capabilities associated with the user 
whose job is being created. 

13 CJ%CAM Set the allowed user capabilities of the new job 

to the combination of (AND function) the 
capability mask in the argument block and the new 
job's user capabilities. If this bit is off, the 
new job has the capabilities associated with the 
user whose job is being created. 
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Bit Symbol Meaning 

14 CJ%SLO Send an IPCF message to the PID supplied in the 

argument block when the new job is logged out. If 

this bit is off, no message is sent when the new 
job is logged out. 

The IPCF logout message has the following format: 

Word Contents 

0, , .IPCLO 

1 N,,# of job logged out. N is the count 
of the remaining words in this message 

(currently 10 octal). 

2 flags , , reserved 

Bits Symbol Meaning 

job is controlled by 
ba tch . 

spooling is deferred, 
the job executed LGOUT. 
the job was forced to 
logout. If this bit is 
on, check word 10 of the 
IPCF message (gives code 
of most recent monitor 
call error). B3 will be 
on only if the job has 
an interrupt to be 
handled by 

MEXEC (Mini-EXEC) . 
B4 SP%OLO the job was logged out 
by another job. Word 6 
of the IPCF message 
contains the job number 
of the job that did the 
logout. 

3 job connect time 

4 job CPU time 

5 TTY number of job at logout (-1 if 
detached) 

6 job number of the job that did the 
logout 

7 reserved 

10 code of the most recent monitor call 
error 

17 CJ%DSN Release ownership of the previously created job 

whose number is in AC3. If this bit is on, it 
overrides the setting of all other bits in AC1; 
and no change is made to the job's status other 
than the change in ownership. 
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t of the argument block (whose address is given in AC2) is as 



Meaning 

Byte pointer to the user name string. 

Byte pointer to the password string. 

5B2 + numeric account number or byte pointer to 
account string. 

Byte pointer to the name of the file to be 
moved (by a GET call) into a process of the new 
job. The new job must have read access to the 
file. The process into which the file is 
placed depends on the setting of B4 (CJ%ETF) . 

Offset in the entry vector to use as the start 
address of the file to which word .CJFIL 
points. This offset is the argument to the 
SFRKV call used to start the process. 

Terminal designator of the new job's 
controlling terminal. This terminal must be 
assigned by the caller. The terminal is then 
released and assigned to the new job. If the 
new job is to be detached, the .NULIO 
designator (377777) is given. 



The 


format 


of the a 


foil 


ows: 




Word 




Symbol 







.CJNAM 


1 




.CJPSW 


2 




.CJACT 


3 




.CJFIL 



.CJSFV 



CJTTY 



.CJTIM 



.CJACS 



.CJEXF 



Connect-time for new job before a 
forced on it; indicates no limit. 



LGOUT is 



Address of a 16-word block whose contents are 
to be loaded in the new job's ACs if a program 
other than the Command Language Processor is 
being run. 

Flag bits to be passed to the Command Language 
Processor in the top-level process of the new 
job. The bits are: 



BO 



Bl 



B2 



B3 



Suppress the herald printed by 
Command Language Processor. 



the 



Move the file to which word .CJFIL 
points into the process whose handle is 
in the PRARG block (see below) . 

Start the process at the offset in the 
entry vector given in word .CJSFV. This 
process is started after the Command 
Language Processor is initialized. 

Output the text printed when a LOGIN 
command is given ( system messages, job 
number, or terminal number, for 
example) . 



This word is copied into the PRARG argument 
block passed to the Command Language Processor 
(see below) . 
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12 



13 



14 



TOPS-20 MONITOR CALLS 
(CRJOB) 



Symbol Meaning 

.CJPRI Primary input and output designators for the 
inferior processes of the new job. These 
designators must refer to device designators. 
The Command Language Processor in the top-level 
process of the new job executes an SPJFN call 
to set these designators. 

.CFCPU Run-time limit for the new job. When this 
limit is reached, an interrupt is generated (by 
a TIMER call), and the Command Language 
Processor executes a LGOUT call for the new 
job. A zero in this word means there is no 
run-time limit on the job. 

.CJCAM Capability mask for the new job. This mask is 
used only if CJ%CAM is set. 

.CJSLO PID to which an IPCF message is to be sent when 
the new job is logged out. 



When CRJOB creates a new job, it also creates the top-level process, 
which is always a virgin process. Thus, an execute-only program can 
be run as the top-level fork. 

The CRJOB call causes other monitor calls to be executed, depending on 
the particular function that is performed. 

Any GTJFN and OPENF errors can occur when obtaining the specified 
file. 

Any SFRKV error can occur when starting the program in the 
specified file. 

Any LOGIN and account validation errors can occur when logging in 
the job. 



CRJOB ERROR MNEMONICS: 



CRJBX1 
CRJBX2 
CRJBX4 
CRJBX5 
CRJBX6 



Invalid parameter or function bit combination 
Illegal for created job to enter MINI-EXEC 
Terminal is not available 
Unknown name for LOGIN 
Insufficient system resources 
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TOPS-20 MONITOR CALLS 
(CRLNM) 

CRLNM JSYS 502 



Defines or deletes; a logical name assignment. Logical names are used 
to specify a set of default values for each field requested by a GTJFN 
monitor call. When a logical name is passed to the GTJFN call, any 
fields not specified by the user are supplied from the fields defined 
in the logical name definition. (Refer to Section 2.2.2 and to the 
INLNM and LNMST monitor call descriptions for more information on 
logical names. ) 

ACCEPTS IN AC1: function code 

AC2: byte pointer to the logical name (A terminating colon 
is optional in the logical name.) 



RETURNS 



AC 3 
+ 1 
+ 2 



byte pointer to the logical name definition string 

failure, error code in AC1 

success, updated string pointer in AC3 



The codes for the functions are as follows: 

.CLNJ1 delete one logical name from the job 

1 .CLNS1 delete one logical name from the system 

2 .CLNJA delete all logical names from the job 

3 .CLNSA delete all logical names from the system 

4 .CLNJB create a logical name for the job 

5 .CLNSY create a logical name for the system 
CRLNM ERROR MNEMONICS: 

ARGX09: Invalid byte size 

CRLNX1: Logical name is not defined 

CRLNX2: WHEEL or OPERATOR capability required 

CRLNX3: Invalid function 

GJFX4: Invalid character in file name 

GJFX5: Field cannot be longer than 39 characters 

GJFX6: Device field not in a valid position 

GJFX7: Directory field not in a valid position 

GJFX8: Directory terminating delimiter is not preceded by a valid 
beginning delimiter 

GJFX9: More than one name field is not allowed 

GJFX10: Generation number is not numeric 

GJFX11: More than one generation number field is not allowed 
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(CRLNM) 

GJFX12: More than one account field is not allowed 

GJFX13: More than one protection field is not allowed 

GJFX14: Invalid protection 

GJFX15: Invalid confirmation character 

GJFX22: Insufficient system resources (Job Storage Block full) 

GJFX31: Invalid wildcard designator 



3-1 



TOPS-20 MONITOR CALLS 
(CVHST) 

CVHST JSYS 276 

Converts a host number to a primary name. 

RESTRICTIONS: for use with ARPANET only 

ACCEPTS IN AC1: destination designator for the ASCIZ string 

AC2: host number 

RETURNS +1: failure 

(Use the GETER call to obtain the error code.) 

+2: success, host name string returned to area designated 
by AC1 

CVHST ERROR MNEMONICS: 

CVHST1: No string for that host number 



3-89 



TOPS-20 MONITOR CALLS 
(CVSKT) 

CVSKT JSYS 275 

Converts a local socket number to absolute form. 
RESTRICTIONS: for use with ARPANET only 
ACCEPTS IN AC1: JFN 
RETURNS +1: failure, error code in AC1 

+2: success, absolute socket number in AC2 
CVSKT ERROR MNEMONICS: 

CVHST1: No string for that host number 
CVSKX1: Invalid JFN 
CVSKX2: Local socket invalid in this context 
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TOPS-20 MONITOR CALLS 
(DEBRK) 

DEBRK JSYS 136 

Dismisses the software interrupt routine in progress and resumes the 
process at the location specified by the PC stored in the priority 
level table. (Refer to Section 2.6.7.) 

RETURNS +1: only if no software interrupt is currently in 
progress and if an ERJMP or EPCAL instruction follows 
the DEBRK 

Generates an illegal instruction interrupt on error conditions below. 

DEBRK ERROR MNEMONICS: 

DBRKX1: No interrupts in progress 
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TOPS-20 MONITOR CALLS 
(DELDF) 

DELDF JSYS 67 



Reclaims disk space by expunging disk files that have been marked for 
deletion with DELF. This call first checks to see that the user has 
connect access to the directory. The calling process must have 
connect access to the directory to expunge files from it. 



RESTRICTIONS 



some functions require WHEEL or OPERATOR capabilities 
enabled . 



ACCEPTS IN AC1: BO (DD%DTF) delete temporary files (;T) also 

Bl (DD%DNF) delete nonexistent files that are not now 
open 

B2(DD%RST) rebuild the symbol table 

B3(DD%CHK) check internal consistency of directory. 
If an error occurs, the symbol table 
should be rebuilt. If B2 (DD%RST) is also 
set, it is ignored; and the DELDF call 
must be executed again with B2 (DD%RST) set 
to rebuild the symbol table. 

AC2: directory number 

RETURNS +1: always 

The directory number given in AC2 must be that of the user's connected 

or logged-in directory unless the process has WHEEL or OPERATOR 

capability enabled, or the process has connect access to the directory 
being deleted. 

If errors still occur after the symbol table is rebuilt, the process 
should restore the directory from magnetic tape; or the user should 
request help from the operator. 

When a file with archive status is deleted and expunged, DELDF sends 
an IPCF message to GALAXY. This message contains all archive status 
information, which includes tape information, as well as the present 
file name, the user who expunged the file, and the time it was 
expunged . 

Generates an illegal instruction interrupt on error conditions below. 

DELDF ERROR MNEMONICS: 



ARGX26 
DELDX1 
DELDX2 
DELFX2 
DELFX4 



File is off line 

WHEEL or OPERATOR capability required 

Invalid directory number 

File cannot be expunged because it is currently open 

Directory symbol table could not be rebuilt 
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DELFX5: Directory symbol table needs rebuilding 

DELFX6: Internal format of directory is incorrect 

DELFX7: FDB formatted incorrectly; file not deleted 

DELFX8: FDB not found; file not deleted 
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TOPS-20 MONITOR CALLS 
(DELF) 

DELF JSYS 26 

Deletes the specified disk file and, if the file is closed, releases 
the JFN. The file is not expunged immediately, but is marked for 
later expunging either by the system or with the DELDF or LGOUT 
monitor calls. 

RESTRICTIONS: some functions require WHEEL or OPERATOR capabilities 
enabled . 

ACCEPTS IN AC1: B0(DF%NRJ) do not release the JFN. 

Bl (DF%EXP) expunge the contents of the file. This 
also deletes the FDB entry in the 
directory. B0(DF%NRJ) and Bl (DF%EXP) 
cannot be set simultaneously. 

B2(DF%FGT) expunge the file but do not deassign its 
addresses. The process must have WHEEL or 
OPERATOR capability enabled to set this 
bit. This bit should be set only by an 
operator or system specialist to delete a 
file that has a damaged or inconsistent 
index block. 

B3 (DF%DIR) delete and expunge a directory file. The 
process must have WHEEL or OPERATOR 
capability enabled to set this bit. This 
bit should be set only by an operator or 
specialist to delete a bad directory. 

B4(DF%ARC) allow a file with archive status to be 
deleted . 

B5(DF%CN0) delete and expunge the contents of the 
file but preserve the file's name and FDB 
as they were (with the exception of the 
page count and the page table address) . 
Setting this bit causes the DELF to fail 
if bit AR%NDL is set in word . FBBBT of the 
FDB, or if a complete set of tape back-up 
information is not in the FDB. 

B18-B35 JFN of the file being deleted. 
(DF%JFN) 

RETURNS +1: failure, error code in AC1 

+2: success, JFN is released unless BO (DF%NRJ) is on or 
the file is open. 

By setting BO (DFINRJ) , the user can delete multiple files by giving a 
JFN to GNJFN that represents a group of files and processing each file 
in the group. 

The DELF call takes the +1 return if the JFN is assigned to a 
nondirectory device. 
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(DELF) 



DELF ERROR MNEMONICS: 



DESX1 

DESX3 

DESX4 

DESX7 

DESX9 

DELFX1 

DELFX2 

DELFX3 

DELFX4 

DELFX5 

DELFX6 

DELFX7 

DELFX8 

DELFX9 

DELF10 

DLFX10 

DLFX11 

DELX12 

DELX13 

WHELX1 



Invalid source/destination designator 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 

Invalid operation for this device 

Delete access required 

File cannot be expunged because it is currently opened 

System scratch area depleted; file not deleted 

Directory symbol table could not be rebuilt 

Directory symbol table needs rebuilding 

Internal format of directory is incorrect 

FDB formatted incorrectly; file not deleted 

FDB not found; file not deleted 

File is not a directory file 

Directory still contains subdirectory 

Cannot delete directory; file still mapped 

Cannot delete directory file in this manner 

File has no pointer to offline storage 

File is marked "Never Delete" 

WHEEL or OPERATOR capability required 



TOPS-20 Version !> 



3-95 



April 1982 



TOPS-20 MONITOR CALLS 
(DELNF) 

DELNF JSYS 317 



Deletes all but the specified number of generations of a disk file. 
The files are marked for deletion and are expunged at a later time, 
either automatically by the system or explicitly with the DELDF or 
LGOUT call. 

ACCEPTS IN AC1: B0(DF%NRJ) do not release the JFN 

B4(DF%ARC) allow a file with archive status to be 
deleted . 

B5(DF%CN0) delete and expunge the contents of the 
file but preserve the file's name and FDB 
as they were (with the exception of the 
page count and the page table address) . 
Setting this bit causes the DELNF to fail 
if bit AR%NDL is set in word . FBBBT of the 
FDB or if a complete set of tape backup 
information is not in the FDB. 

B18-B35 JFN of the file being deleted 

AC2: the number of generations to retain 

RETURNS +1: failure, error code in AC1 

+2: success, with the number of files deleted in AC2 

Starting at the file specified by the JFN, the DELNF call decrements 
the generation number, first retaining the specified number of 
generations before deleting the remaining generations. 

DELNF ERROR MNEMONICS: 

DELX13: File is marked "Never Delete" 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX7: Illegal use of parse-only JFN or output wildcard-designators 

DELFXl: Delete access required 
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(DEQ) 

DEQ JSYS 514 

Removes a request for a specific resource from the queue associated 
with that resource. The request is removed whether the process has a 
lock for the resource, or is only waiting in the queue for the 
resource . 

This call can be used to remove any number of requests. If one of the 
requests cannot be dequeued, the dequeueing procedure continues until 
all requests that can be dequeued have been. An error return is given 
for the last request found that could not be dequeued. The process 
can then execute the ENQC call to determine the current status of each 
request. However, if the process attempts to dequeue more pooled 
resources than it originally allocated, the error return is taken and 
none of the pooled resources are dequeued. 

Refer to the TOPS-20 Monitor Calls User's Guide for an overview and 
description of the Enqueue/Dequeue facility. 

RESTRICTIONS: When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

ACCEPTS IN AC1: function code 

AC2: address of argument block (required only for the 
.DEQDR function) 

RETURNS +1 : failure, error code in AC1 

+2: success 

The available functions are as follows: 

Code Symbol Meaning 

.DEQDR Remove the specified requests from the queue. 

This function is the only one requiring an 
argument block. 

1 .DEQDA Remove all requests for this process from the 

queues. This action is taken on a RESET or 
LGOUT call. The error return is taken if the 
process has not given an ENQ call. 

2 .DEQID Remove all requests that correspond to the 

specified request identifier (ID) . This 
function allows the process to release a 
class of locks in one call without itemizing 
each lock in an argument block. It is useful 
when dequeueing in one call the same locks 
that were enqueued in one call. To use this 
function, the process places the 18-bit 
request ID in AC2. 

The format of the argument block for function .DEQDR is identical to 
that given on the ENQ call. (Refer to the ENQ monitor call 
description.) However, the .ENQID word of the argument block is not 
used on a DEQ call and must be zero. 
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DEQ ERROR MNEMONICS: 

DESX5: File is not open 

ENQX1: Invalid function 

ENQX2: Level number too small 

ENQX3: Request and lock level numbers do not match 

ENQX4: Number of pool and lock resources do not match 

ENQX6: Requested locks are not all locked 

ENQX7: No ENQ on this lock 

ENQX9: Invalid number of blocks specified 

ENQX10: Invalid argument block length 

ENQX11: Invalid software interrupt channel number 

ENQX13: Indirect or indexed byte pointer not allowed 

ENQX14: Invalid byte size 

ENQX15: ENQ/DEQ capability required 

ENQX16: WHEEL or OPERATOR capability required 

ENQX17: Invalid JFN 

ENQX18: Quota exceeded 

ENQX19: String too long 

ENQX20: Locked JFN cannot be closed 

ENQX21: Job is not logged in 

DESX8: File is not on disk 



3-9! 



TOPS-20 MONITOR CALLS 
(DEVST) 

DEVST JSYS 121 



Translates the given device designator to its corresponding ASCIZ 
device name string. The string returned contains only the 
alphanumeric device name; it does not contain a colon. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



destination designator 
device designator 
failure, error code in AC1 

success, updated string pointer in AC1, if pertinent 

string to its 



The STDEV monitor call can be used to translate a 
corresponding device designator. 

DEVST ERROR MNEMONICS: 



DEVX1 
DESXl 
DESX2 
DESX3 
10X11 
10X34 
10X3 5 



Invalid device designator 

Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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(DFIN) 

DFIN JSYS 234 



Inputs a double-precision, floating-point number, rounding if 
necessary. 



ACCEPTS IN AC1 
RETURNS +1 

+ 2 



source designator 

failure, error code in AC4 and updated string pointer 
in AC1, if pertinent. 

success, double-precision, floating-point number in 
AC2 and AC3 and updated string pointer in AC1, if 
pertinent . 



DFIN ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX5 

FLINX1 

FLINX2 

FLINX3 

FLINX4 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

First character is not blank or numeric 

Number too small 

Number too large 

Invalid format 
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(DFOUT) 

DFOUT JSYS 235 



Outputs a double-precision, floating-point number. 

ACCEPTS IN AC1: destination designator 

AC2: first word of a normalized, double-precision, 
floating-point number 

AC3: second word of a normalized, double-precision, 
floating-point number 



AC4 



format control word. (Refer to Section 2.9.1.2.) 



RETURNS 



+1 : failure, error code in AC4 and updated string pointer 
in AC1, if pertinent. 



+2: success, updated string pointer in AC1, if pertinent. 
DFOUT ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX5 

FL0TX1 

FLOTX2 

FL0TX3 

10X11 

10X34 

10X35 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

Column overflow in field 1 or 2 

Column overflow in field 3 

Invalid format specified 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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(DIAG) 

DIAG JSYS 530 

Reserves a channel and either a single device or all devices attached 
to that channel. This call is also used to release the channel and 
its devices. When the request is made, no new activity is initiated 
on the requested channel, and the monitor waits for current activity 
on all devices connected to the channel to be completed. When the 
channel becomes idle, the process requesting the channel continues 
running . 

The DIAG JSYS can also be used to get and release memory. The .DGGEM 
function is used by the system program TGHA for performing its spare 
bit substitution. 

RESTRICTIONS: requires WHEEL, OPERATOR, or MAINTENANCE capabilities 
enabled . 

ACCEPTS IN AC1: negative length of the argument block in the left 
half, and address of the argument block in the right 
half. 

RETURNS +1: failure, error code in AC1 

+2: success 

The available functions are as follows: 

Function Symbol Meaning 

1 .DGACU Assign the channel and a single device. Release 

the device after the time limit specified. 

Argument block: 
Word Contents 

function code 

1 device address 

2 time limit in milliseconds 

2 .DGACH Assign the channel and all devices. 

Argument block: 
Word Contents 

function code 

1 device address 

3 .DGRCH Release the channel and all assigned devices. 

Argument block: 
Word Contents 

function code 

1 device address 
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(DIAG) 

Function Symbol Meaning 

4 .DGSCP Set up the channel program. The data transfer can 
be up to 50 pages. This function locks in memory 
the user page to which the channel control word 
points. This function also causes the system to 
update the Exec Process Table location 
corresponding to the channel with the appropriate 
channel control word (physical address) . 

Argument block: 

Word Contents 

function code 

1 device address 

2 channel control word 

3 channel control word 1 



n+2 channel control word n 

5 .DGRCP Release the channel program. The page for the 

specified channel, to which page the channel 
control word points, is unlocked. This function 
is not required before specifying a new channel 
program. 

Argument block: 

Word Contents 

function code 

1 device address 

6 .DGGCS Return the status of the channel. The argument 

block contains the logout area for the channel. 

Argument block: 
Word Contents 

function code 

1 device address 

2-5 4-word channel logout area 

100 .DGGEM Get memory (for TGHA) . 
Argument block: 
Word Contents 

function code 

1 first page in user address space 

2 first physical memory page 

3 number of pages 

4 user address of AR/ARX parity trap 
routines 
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(DIAG) 

Function Symbol Meaning 

100 .DGGEM (Cont.) 

Upon successful return, this function accomplishes the following: 

1. TOPS-20 has requested that all of the front 
ends refrain from accessing common memory. 

2. The hardware PI system has been turned off; 
no scheduling can occur. 

3. The time base and interval timer have been 
turned off. 

4. All DTE byte transfers have been completed. 

5. All RH20 activity has ceased. 

6. The designated pages of the process address 
space have been set up to address the 
designated physical memory. Note that this is 
not the same as requesting the pages with 
PLOCK. With the get memory function, the data 
in the physical memory pages have been 
retained, and ownership of the pages is 
unchanged . 

7. The CSTO entries for each of the designated 
physical pages have been saved and set as 
follows: 

A The age is set to the present age of the 

requesting process. 
B The process use field is set to all ones. 
C The modified bit is set to one. 

8. The entire address space of the requesting 
process has been locked in memory. (Actually, 
only the pages that existed at the time of the 
DIAG call are locked. Therefore, the process 
must ensure that all of the pages it needs 
exist and are private when DIAG is executed.) 

9. The monitor has set up proper dispatch if TGHA 
specified an AR/ARX trap address. 

101 .DGREM Release memory (for TGHA) 

Argument block: 

Word Contents 

function code 
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(DIAG) 



Function Symbol 
102 .DGPDL 



Meaning 



Inform the monitor that a device previously 
unknown to it is now available for use (is now 
online). This functon is used with devices 
interfaced through the DX20 (TX01, TX03, TX05, 
TU70, or TU72) . Argument block: 

Word Contents 

function code 

1 primary channel number 

2 primary unit number 

3 primary controller number (-1 if no 
controller) 

4 alternate channel number 

5 alternate unit number (should be same as 
primary unit number) 

6 alternate controller number (-1 if no 
controller) 

The device address given in some of the argument blocks is a 
machine-dependent specification for the channel and device to be 
assigned. The devices that can be assigned must be attached to the 
RH20 controller and must be mounted by a process with either WHEEL, 
OPERATOR, or MAINTENANCE capability enabled. The format of the device 
address word is: 



2 3 9 10 23 24 29 30 35 

[============:===========================================! 

! address ! device ! ! unit ! subunit ! 
! type ! code III 1 

1= = = = = = = = = = = =: = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =! 



DIAG ERROR MNEMONICS 



DIAGX1 
DIAGX2 
DIAGX3 
DIAGX4 
DIAGX5 
DIAGX6 
DIAGX7 
DIAGX8 
DIAGX9 
DIAG10 
DIAG11 



Invalid function 

Device is not assigned 

Argument block too small 

Invalid device type 

WHEEL, OPERATOR, or MAINTENANCE capability required 

Invalid channel command list. 

Illegal to do I/O across page boundary 

No such device 

Unit does not exist 

Subunit does not exist 

Device is already on-line 
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(DIBE) 

DIBE JSYS 212 

Dismisses the process until the designated file input buffer is empty. 

ACCEPTS IN AC1: file designator 

RETURNS +1: always 

Returns immediately if the designator is not associated with a 
terminal . 

The DOBE monitor call can be used to dismiss the process until the 
designated file output buffer is empty. 

Generates an illegal instruction interrupt on error conditions below. 

DIBE ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX5: File is not open 

DEVX2: Device already assigned to another job 

TTYX01: Line is not active 
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TOPS-20 MONITOR CALLS 
(DIC) 

DIC JSYS 133 



Deactivates the specified software interrupt channels. (Refer to 
Section 2.6.1.) 

ACCEPTS IN AC1: process handle 

AC2: 36-bit word 

Bit n means deactivate channel n 

RETURNS +1: always 

Software interrupt requests to deactivated channels are ignored except 
for interrupts generated on panic channels. Panic channel interrupts 
are passed to the closest superior process that has the specific 
channel enabled. 

The AIC monitor call is used to activate specified software interrupt 
channels. 

Generates an illegal instruction interrupt on error conditions below. 

DIC ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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DIR 



JSYS 130 



Disables the software interrupt system for a process. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always 

If software interrupt requests are generated while the interrupt 
system is disabled, the requests are remembered and take effect when 
the interrupt system is reenabled unless an intervening CIS call is 
executed. However, interrupts on panic channels will still be 
generated even though the system is disabled. 

In addition, if the CTRL/C terminal code is assigned to a channel, it 
will still generate an interrupt that cannot be disabled with a DIR 
call. CTRL/C interrupts can be disabled by deactivating the channel 
to which the code is assigned or by monitor action. 

The EIR monitor call can be used to enable the software interrupt 
system for a process. 

Generates an illegal instruction interrupt on error conditions below. 

DIR ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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DIRST JSYS 41 

Translates the specified 36-bit user or directory number to its 
corresponding string and writes it to the given destination. When a 
user number is given, the string returned is the corresponding user 
name without any punctuation. When a directory number is given, the 
string returned is the corresponding structure and directory name 
including punctuation (structure : <d irectory> ) . 



ACCEPTS IN AC1 

AC 2 

RETURNS +1 

+ 2 



destination designator 

user or directory number 

failure, with error code in AC1. 

success, string written to destination, 
string pointer, if pertinent, in AC1 



updated 



The RCDIR monitor call can be used to translate a directory string to 
its corresponding directory number. The RCUSR monitor call can be 
used to translate a user name string to its corresponding user number. 

DIRST ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX5 

DELFX6 

DIRX1 

DIRX2 

DIRX3 

STRX01 

10X11 

10X34 

10X35 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

Internal format of directory is incorrect 

Invalid directory number 

Insufficient system resources 

Internal format of directory is incorrect 

Structure is not mounted 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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DISMS JSYS 167 

Dismisses this process for the specified amount of time. 

ACCEPTS IN AC1: number of milliseconds for which the process is to be 
dismissed 

RETURNS +1: when the elapsed time is up 

The maximum argument specifiable in AC1 is 400,, (18 hours, 38 
minutes, 28 seconds, and 864 milliseconds). If this value is 
exceeded, the argument is ignored and the maximum dismiss time is 
used. The time resolution is limited to the scheduling frequency 
(about 20 milliseconds). 
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DOBE JSYS 104 



Dismisses the process until the designated file output buffer is 
empty. 

ACCEPTS IN AC1: destination designator 

RETURNS +1: always 

Returns immediately if designator is not associated with a terminal. 

The DIBE monitor call can be used to dismiss the process until the 
designated file input buffer is empty. 

Generates an illegal instruction interrupt on error conditions below. 

DOBE ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX5: File is not open 

DEVX2: Device already assigned to another job 

TTYX01: Line is not active 
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DSKAS JSYS 244 

Assigns or deassigns specific disk addresses. 

RESTRICTIONS: requires WHEEL or OPERATOR capabilities enabled. 

ACCEPTS IN AC1: BO (DA%DEA) deassign the specified address. If the 

address is currently assigned, control 
returns to the next instruction following 
the call (+1 return) . If the address was 
not previously assigned, a BUGCHK occurs. 

B1(DA%ASF) assign a free page near the specified 
address. Assignment is on the same 
cylinder as the specified address, if 
possible, or on a nearby cylinder. If the 
specified address is 0, a page is assigned 
on a cylinder that is at least one-half 
free. If the assignment is not possible 
because the disk is full, control returns 
to the next instruction following the 
call. 

B2 (DA%CNV) convert the specified address according to 
the setting of B3 (DA%HWA) . 

B3(DA%HWA) the specified address is a hardware 
address. If this bit is off, the 
specified address is a software address. 

B4(DA%INI) initialize a private copy of the bit 
table . 

B5(DA%WRT) write the private copy of the bit table to 
a new bit table file. 

B18-B35 disk address 
(DA%ADR) 

AC2: device designator of structure. If DA%CNV is on in 
AC1, this argument is not required. 

RETURNS +1: failure, address already assigned or cannot be 
assigned 

+2: success, address assigned in AC1 

Generates an illegal instruction interrupt on error conditions below. 

DSKAS ERROR MNEMONICS: 

WHELX1: WHEEL or OPERATOR capability required 
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DSKOP JSYS 242 

Allows the process to reference physical disk addresses when 
performing disk transfers. This monitor call requires the process to 
have WHEEL, OPERATOR, or MAINTENANCE capability enabled to read and 
write data. However, a process with only MAINTENANCE capability 
enabled can write data only if it is using physical addresses (.DOPPU) 
and writing to a unit that is not part of a mounted structure. 

RESTRICTIONS: requires WHEEL or OPERATOR capabilities enabled. 
Some functions can be performed with MAINTENANCE 
capabilities enabled. 

ACCEPTS IN AC1: BO-Bl (DOP%AT) field indicating the address type. 

For physical channel and unit 
addresses, the value of the field is 
1 (.DOPPU) and the remainder of AC1 is 
B2-B6 (DOP%CN) channel number 
B7-B12 (DOP%UN) unit number 
B.13-B35 (DOP%UA) unit address 
For physical channel, controller, and 
unit numbers, refer to AC4. 

For a structure and a relative 
address, the value of the field is 
2(.D0PSR) and the remainder of AC1 is 
B2-B10 (DOP%SN) structure designator 
flag (0 is structure PS:). A 
yalue of -1 means the structure is 
indicated by the structure 
designator (refer to Section 2.4) 
in AC4. 
Bll-B35(DOP%RA) relative address 

Any other values for this field are 
illegal . 

AC2: control flags in the left half and a count of the 
number of words to transfer in the right half. The 
control flags are: 

B9(DOP%NF) use values in AC4 for channel, 
controller, and unit numbers 

B10(DOP%EO) error if unit offline 

Bll(DOP%IL) inhibit error logging 

B12(DOP%IR) inhibit error recovery 

B14(DOP%WR) write data to the disk. If this bit is 
off, read data from the disk. 

B18-B35 word count. If this count is less than 
(DOP%CT) or equal to 1000, the data to be 
transferred cannot straddle a page 
boundary. Thus the caller's buffer 
should start at a page boundary and 
cannot be longer than one page. 

If this count is more than 1000, the 
data to be transferred can straddle a 
page boundary, so the caller's buffer 
need not start on a page boundary, and 
the buffer can be larger than one page. 
Two restrictions apply, however. First, 
the buffer must be a multiple of the 
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RETURNS 



size of the sectors on the disk being 
read or written. (Obtain the sector 
size by using the .MSRUS function of the 
MSTR JSYS.) Second, no error processing 
is done (the JSYS executes as though the 
DOP%IL and DOP%IR bits were set) . On an 
error, the pages must be read one at a 
time to determine which pages caused 
errors . 

AC3: address in caller's address space from which data is 
written or into which data is read. 

AC4: device designator of the structure. This word is 
used if the value given for DOP%SN is -1. 

or 
physical channel, controller, and unit numbers if 
B9(D0P%NF) in AC2 is on. In this case, 

B0-B11 (D0P%C2) channel number 
B12-B23 (D0P%K2) controller number 
B13-B35 (D0P%U2) unit number 

+1: always, AC1 is nonzero if an error occurred, or zero 
if no error occurred. 



If an error occurs and DOP%IL is on in the call, no error logging is 
performed. If DOP%IL is off, the standard system error logging is 
performed . 

If an error occurs and DOP%IR is on in the call, no retries or ECC 
corrections, if applicable, are attempted. If DOP%IR is off, the 
standard system error recovery procedure is followed. 

An error occurs if the format for channel, controller, and unit number 
is used with Release 4 or any previous monitor. 

Generates an illegal instruction interrupt on error conditions below. 

DSKOP ERROR MNEMONICS: 



WHELX1 
DSK0X1 
DSKOX2 
DSK0X3 
DSK0X4 
DECRSV 



WHEEL or OPERATOR capability required 
Channel number too large 
Unit number too large 
Invalid structure number 
Invalid address type specified 
DEC-reserved bits not zero 
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(DTACH) 

DTACH JSYS 115 

Detaches the controlling terminal from the current job. (The ATACH 
call with bit 1 (AT%NAT) of AC2 set can be used to detach a job other 
than the current job.) A console-detached entry is appended to the 
accounting data file. 

RETURNS +1: always 

The DTACH call is ignored if the job is already detached. 

The ATACH monitor call is used to attach the controlling terminal to a 
specified job. 
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(DTI) 

DTI JSYS 140 

Deassigns a terminal interrupt code. 

ACCEPTS IN AC1: terminal interrupt code; refer to Section 2.6.6 

RETURNS +1: always 

The DTI call is a no-op if the specified terminal code was not 
assigned by the current process. 

The ATI monitor call is used to assign a terminal code. 

Generates an illegal instruction interrupt on error conditions below. 

DTI ERROR MNEMONICS: 

TERMX1: Invalid terminal code 
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(DUMPI) 

DUMPI JSYS 65 

Reads data words into memory in unbuffered data mode. The file must 
be open for data mode 17. (Refer to Section 2.4.7.5 for information 
about unbuffered magnetic tape I/O.) 

ACCEPTS IN AC1: JFN 

AC2: BO (DM%NWT) do not wait for completion of requested 

operation 

B18-B35 address of command list in memory 
(DM%PTR) 

RETURNS +1: failure, error code in AC1, pointer to offending 
command in AC2 

+2: success, pointer in AC2 updated to last command 

The use of BO (DM%NWT) allows data operations to be double-buffered 
with a resulting increase in speed. When this bit is on, DUMPI/DUMPO 
returns immediately after the request is queued. This allows the 
program to overlap computations with I/O transfers. If the second 
request is then made, the program is blocked until the first request 
is completed. Generally, for a sequence of overlapped DUMPI/DUMPO 
calls, return from the Nth call indicates that the Nth-1 request has 
completed and that the Nth request is now in progress. This bit is 
implemented only for magnetic tape. 

The GDSTS call can be used after the transfer is completed to 
determine the number of bytes read. 

If an error occurs on the Nth request, the failure return is given on 
the Nth+1 call, and the Nth+1 request is ignored. This means that the 
program will discover an error on a request only after making the next 
request. The next request is ignored to prevent improper operation 
and must be reissued after the error has been processed. The GDSTS 
call can be executed to determine the cause for the error. 

COMMAND LIST FORMAT 

Three types of entries may occur in the command list. 

1. IOWD n, loc - Causes n words to be transferred from the file 
to locations loc through loc+n-1 of the process address 
space. The next, command is obtained from the location 
following the IOWD. For magnetic-tape files, 1 IOWD word 
reads 1 physical tape record. For labeled magnetic-tape 
files, the data format must be "U". 

The IOWD pseudo-op generates XWD -n,loc-l. 

2. XWD 0, y - Causes the next command to be taken from location 
y. Referred to as a GOTO word. 

3. - Terminates the command list. 
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DUMPI ERROR MNEMONICS: 

DUMPX1: Command list error 

DUMPX2: JFN is not open in dump mode 

DUMPX3: Address error (too big or crosses end of memory) 

DUMPX4: Access error (cannot read or write data in memory) 

DUMPX5: No-wait dump mode not supported for this device 

DUMPX6: Dump mode not supported for this device 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX5: File is not open 

10X1: File is not opened for reading 

10X4: End of file reached 

10X5: Device or data error 
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(DUMPO) 

DUMPO JSYS 66 

Writes data words from memory in unbuffered data mode. The file must 
be open for data mode 17. (Refer to Section 2.4.7.5 for information 
about unbuffered magnetic tape I/O.) 

ACCEPTS IN AC1: JFN 

AC2: BO (DM%NWT) do not wait for completion of requested 

operation 

B18-B35 address of command list in memory 
(DM%PTR) 

RETURNS +1: failure, error code in AC1, pointer to offending 
command in AC2 

+2: success, pointer in AC2 updated to last command 

This call locks in memory the pages to be transferred. Any attempt to 
write to these pages while DUMPO has them locked results in an illegal 
memory reference. 

The use of BO (DM%NWT) allows data operations to be double-buffered 
with a resulting increase in speed. When this bit is on, DUMPI/DUMPO 
returns immediately after the request is queued. This allows the 
program to overlap computations with I/O transfers. If the second 
request is then made, the program is blocked until the first request 
is completed. Generally, for a sequence of overlapped DUMPI/DUMPO 
calls, return from the Nth call indicates that the Nth-1 request has 
completed and that the Nth request is now in progress. This bit is 
implemented only for magnetic tape. 

COMMAND LIST FORMAT 

Three types of entries may occur in the command list. 

1. IOWD n, loc - Causes n words from loc through loc+n-1 to be 
transferred from the process address space to the file. The 
next command is obtained from the location following the 
IOWD. For mag-tape files, 1 IOWD word writes 1 physical tape 
record. For labeled mag-tape files, the data format must be 
"U" . 

NOTE 

Dump mode output to a labeled tape can override the 
block-size limit specified in the GTJFN. If any 
write produces a block in excess of the specified 
block-size parameter, then the file can be read only 
in clump mode. 

The IOWD pseudo-op generates XWD -n,loc-l. 

2. XWD 0, y - Causes the next command to be taken from location 
y. Referred to as a GOTO word. 

3. - Terminates the command list. 
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The GDSTS call can be used after the transfer is completed to 
determine the number of bytes written. 

DUMPO ERROR MNEMONICS: 



DUMPX1 

DUMPX2 

DUMPX3 

DUMPX4 

DUMPX5 

DUMPX6 

DESX1 

DESX2 

DESX3 

DESX4 

DESX5 

IOX2: 

10X5: 

10X11 

10X34 

10X35 



Command list error 

JFN is not open in dump mode 

Address error (too big or crosses end of memory) 

Access error (cannot read or write data in memory) 

No-wait dump mode not supported for this device 

Dump mode not supported for this device 

Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 

File is not opened for writing 

Device or data error 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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DVCHR JSYS 117 



Returns the characteristics of the specified device. 
ACCEPTS IN AC1: JFN or device designator 
RETURNS +1: always, with 



+ 1 
AC1 
AC2 



containing the device designator (even if a JFN was 
given) . 

containing the device characteristics word. 
AC3 containing the job number to which the device is 
assigned in the left half and the unit number in the 
right half. If the device is a structure or does not 
have units, the right half is -1. 

The left half of AC3 contains -1 if the device is not assigned to any 
job or -2 if the device allocator has ownership of the device. 



Bit 


1 
2 
3 
4 
5 

6 
8 
9-17 



20-35 



Device Characteristics Word 



Symbol 

DV%OUT 

DV%IN 

DV%DIR 

DVIAS 

DV%MDD 

DVIAV 

DV%ASN 
DV%MNT 
DV%TYP 



DV%MOD 



Meaning 



device 


can do outpu 


t 


device 


can do input 




device 


has a directory 


device 


is assignabl 


e with ASND 


device 


has multiple 


director ies 


device 


is available 


or assigned to this 


job 






device 


is assigned 


by ASND 


device 


is mounted 




device 


type 







.DVDSK 


disk 


2 


.DVMTA 


magnetic tape 


7 


.DVLPT 


line printer 


10 


.DVCDR 


card reader 


11 


.DVFE 


front-end 
pseudo-device 


12 


.DVTTY 


terminal 


13 


.DVPTY 


pseudo-terminal 


15 


.DVNUL 


null device 


16 


.DVNET 


ARPA network 


22 


.DVDCN 


DECnet active 
component 


23 


.DVSRV 


DECnet passive 
component 


data mode in which 


device can be opened 


B20 


DV%M17 


dump mode 


B27 


DV%M10 


image mode 


B34 


DV%M1 


small buffer mode 


B35 


DV%M0 


normal mode 
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Generates an illegal instruction interrupt on error conditions below, 
DVCHR ERROR MNEMONICS: 



DEVX1 
DESX1 
DESX3 
DESX4 



Invalid device designator 

Invalid source/destination designator 

JFN is not assigned 

Invalid use of terminal designator or string pointer 



3-122 



TOPS-20 MONITOR CALLS 
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EIR JSYS 126 



Enables the software interrupt system for a process. (Refer to 
Section 2.4.) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always 

The DIR monitor call can be used to disable the software interrupt 
system for a process. 

Generates an illegal instruction interrupt on error conditions below. 

EIR ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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(ENQ) 

ENQ JSYS 513 

Requests access to a specific resource by placing a request in the 
queue for that resource. This call can be used to request any number 
of resources. 

Refer to the TOPS-20 Monitor Calls User's Guide for an overview and 
description of the Enqueue/Dequeue facility. 

RESTRICTIONS: some functions require WHEEL or OPERATOR capabilities 
enabled . 

When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

ACCEPTS IN AC1: function code 

AC2: address of argument block 

RETURNS +1: failure, error code in AC1 

+2: success 

The available functions are as follows: 

Code Symbol Meaning 

.ENQBL Queue the requests and block the process 

until all requested locks are acquired. The 
error return is taken only if the call is not 
correctly specified. 

1 . ENQAA Queue the requests and acquire the locks only 

if all requested resources are immediately 
available. No requests are queued and the 
error return is taken if any one of the 
resources is not available. 

2 .ENQSI Queue the requests. If all requested 

resources are immediately available, this 
function is identical to the .ENQBL function. 
If all resources are not immediately 
available, the request is queued and the the 
call fails with the ENQX6 error. A software 
interrupt will occur when all requested 
resources have been given to the process. 

3 . ENQMA Modify the access of a previously queued 

request. (Refer to EN%SHR below.) The access 
of each lock in this request is compared with 
the access of each lock in the previously 
queued request. If the two accesses are the 
same, no modification is needed or made. 
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Code Symbol Meaning 

3 .ENQMA If the access in this request is shared and 

(Cont.) the access in the previous request is 

exclusive, the call succeeds. If the access 

in this request is exclusive and the access 

in the previous request is shared, this 
function returns an error unless this process 

is the only user of the lock. If the caller 

is the only user of this lock, the call 

succeeds. The error return is also taken if: 

1. Any one of the specified locks does not 
have a pending request. 

2. Any one of the specified locks is a 
pooled resource. 

This function checks each lock specified, and 
the access is changed for all locks that were 
given correctly. If the call fails, the user 
must execute the ENQC call to determine the 
current state of each lock. 

The format of the argument block is as follows: 

Word Symbol Meaning 

.ENQLN length of the header and the number of 

requested locks in the left half, and length 
of argument block in the right half. 

1 .ENQID software interrupt channel number in the left 

half, and the request ID in the right half. 

2 .ENQLV flags and level number in the left half, and 

JFN, -1, -2, or -3 in the right half (see 
below) . 

3 .ENQUC pointer to a string or a 5B2+33-bit user 

code. 

4 .ENQRS number of resources in pool in the left half 

and number of resources requested in the 
right half, or in the left half and a group 
number in the right half. 

5 .ENQMS address of a resource mask block. 



n-4 flags and level number in the left half, and 

JFN, -1, -2, or -3 in the right half. 

n-3 pointer to a string or a 5B2+33-bit user 

code. 

n-2 number of resources in pool in the left half 

and number of resources requested in the 
right half, or in the left half and a group 
number in the right half. 

n-1 address of a resource mask block. 
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(ENQ) 

The following paragraphs describe the words in the argument block. 

The argument block is divided into two logical sections: a header and 
individual requests for each desired lock. Words . ENQLN and .ENQID 
form the header. Word .ENQLV through word . ENQMS form the individ is 
notual request and are repeated for each lock being requested. The 
words in the argument block are described in the following paragraphs. 

.ENQLN 

The length of the header (.ENHLN) is contained in bits through 5. 
Currently, the length of the header is two words. (Note that a given 
length of zero or one is assumed to be equal to a length of two.) The 
number of locks being requested (.ENNLK) is contained in bits 6 
through 17, and the length of the argument block (.ENALN) is contained 
in bits 18 through 35. 

.ENQID 

The software interrupt channel specifies the number of the channel on 
which to generate an interrupt with the .ENQSI function. The request 
ID is an 18-bit user-generated value used to identify the particular 
resource. This ID currently used by the system but is stored for 
future expansion of the facility. 

.ENQLV 

The following flags are defined: 

BO (EN%SHR) Access to this resource is to be shared. If this bit 
is not set, access to the resource is to be exclusive. 

Bl (EN%BLN) Ignore the level number associated with this resource. 
Sequencing errors in level numbers will not be 
considered fatal, and execution of the call will 
continue. If a sequencing error occurs, the successful 
return is taken, and AC1 will contain an error code 
indicating the sequencing error that occurred. 

B2 (EN%NST) Allow ownership of this lock to be nested to any level 
within a process. This means that a process can 
request this resource again even though it already owns 
it. If the process has a request in the resource's 
queue or if the process already owns the lock, the 
ownership of the lock is nested to a depth one greater 
than the current depth. If the process does not have a 
request in the resource's queue, the setting of this 
bit has no effect, and the execution of the ENQ call 
continues. When a process has a nested lock, it must 
DEQ the resource as many times as it ENQed it before 
the resource becomes available to other processes. 

B3 (EN%LTL) Allow a long-term lock on this resource. This notifies 
the system that this resource will be locked and 
unlocked many times in a short period of time. Setting 
this bit permits a program to run faster if it is doing 
multiple locks and unlocks on the same resource because 
the argument block data is not deleted immediately from 
the ENQ/DEQ data base when a DEQ call is executed. 
Thus, the time required to re-create the data is 
reduced . 

B9-B17 Level number associated with this resource. 
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(EN%LVL) 

The request is not queued and the error return is taken if EN%ELN is 
not set and 

1. A resource with a level number less than or equal to the 
highest numbered resource requested so far is specified. 

2. The level number of the current request does not match the 
level number supplied on previous requests for this resource. 

The right half of . ENQLV specifies the type of access desired for the 
resource. If a JFN is given, the file associated with the JFN is 
subject to the standard access protection of the system. The file 
associated with the JFN in the right half of .ENQLV must be opened 
before the ENQ is performed or an error will be generated. If -1 is 
given, the resource can be accessed only by processes of the job. If 
-2 is given, the resource can be accessed by any job on the system. 
(The process must have ENQ capability enabled to specify -2.) If -3 is 
given, the resource can be accessed only by processes that have WHEEL 
or OPERATOR capability enabled. 

.ENQUC 

This word is either a byte pointer or a 33-bit user code, either of 
which serves to uniquely identify the resource to all users. This 
quantity is the second part of the resource name. (JFN, -1, -2, or -3 
is the first part of the resource name.) The system makes no 
association between these identifiers and any physical resource. 

The string identified by the byte pointer can contain bytes of any 

size (from 1 to 36 bits) , and is terminated by a null byte. The byte 

size is specified by the byte pointer. The maximum length of the 
string (including the terminating null byte) is 50 words. 

.ENQRS 

This word is used to allocate multiple resources from a pool of 
identical resources. The left half contains the number of resources 
in the pool, and is a parameter agreed upon by all users. All 
requests for the same pooled resource must agree with the original 
count or the call fails. The number of resources requested from the 
pool must be greater than zero if a pool exists, and must be less than 
or equal to the number in the pool. 

If the left half of this word is zero, the system assumes only one 
resource of the specific type exists. In this case, if the right half 
of this word is positive, it is interpreted as the number of the group 
of users who can simultaneously access the resource. 

.ENQMS 

Obtains a single lock representing many specific resources. For 
example, a lock can be obtained on a particular data base, and the 
specific resources requested can be individual records in that data 
base. 

This word contains an address of a mask block, consisting of a count 
word and a group of mask words. The first word of the mask block 
contains a count (in the right half-word) of the number of words in 
the block, including the count word. The remaining words each contain 
36 mask bits, where each bit represents a specific resource of the 
lock. The maximum length of the mask block is 16 words. All requests 
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for the resources associated with the mask block must specify the same 
length for the block or an error return is taken. Also, when a mask 
block is specified, the ENQ call must request exclusive access to the 
resource and the left half of word . ENQRS of the lock request must be 
zero. 

The set of resources comprising the lock is a parameter agreed upon by 
all users. A process can obtain exclusive access to all or some of 
the specific resources comprising the lock. When a process requires 
exclusive access to all the resources, it executes an ENQ call (for 
exclusive access) and does not specify a mask block. A successful 
return is given if there are no other processes that have issued an 
ENQ call for that lock. Otherwise, the process blocks until the 
requested resources are available. 

When a process requires exclusive access to some of the specific 
resources comprising the lock, it sets up the mask block and sets the 
bits corresponding to the specific resources it wants to lock. The 
process then executes an ENQ call for exclusive access. On successful 
execution of the ENQ call, the process has an exclusive lock for the 
resources represented by the bits on in the mask. The process blocks 
if another process owns an exclusive lock on the resource and that 
process' ENQ call has not specified a mask block. 

Once a mask block has been set up for a set of specific resources, 
subsequent requests for a different set of resources will be honored. 
The set of resources being requested is considered different if the 
bits on in one process' mask block are not on in another process' mask 
block. When a subsequent request is given for resources that are 
currently locked by a process, the process with the request blocked 
until the last of the currently locked resources is dequeued by the 
owner of the lock. 

A process can dequeue all or part of the original ENQ call request. 
When a DEQ call is executed, the bits on in the mask block of the DEQ 
call are compared with the bits on in the original ENQ call. The 
resources not being dequeued remain locked and must be dequeued by a 
subsequent DEQ call. This action allows a process to lock a number of 
resources all at once, and then to release individual resources as it 
finishes with them. However, a process cannot execute subsequent ENQ 
calls to request additional resources from those requested in its 
original ENQ call. 

ENQ ERROR MNEMONICS: 



DESX5 
ENQX1 
ENQX2 
ENQX3 
ENQX4 
ENQX5 
ENQX6 
ENQX8 
ENQX9 



File is not open 

Invalid function 

Level number too small 

Request and lock level numbers do not match 

Number of pool and lock resources do not match 

Lock already requested 

Requested locks are not all locked 

Invalid access change requested 

Invalid number of blocks specified 
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ENQX10: Invalid argument block length 

ENQX11: Invalid software interrupt channel number 

ENQX12: Invalid number of resources requested 

ENQX13: Indirect or indexed byte pointer not allowed 

ENQX14: Invalid byte size 

ENQX15: ENQ/DEQ capability required 

ENQX16: WHEEL or OPERATOR capability required 

ENQX17: Invalid JFN 

ENQX18: Quota exceeded 

ENQX19: String too long 

ENQX20: Locked JFN cannot be closed 

ENQX22: Invalid mask block length 

ENQX23: Mismatched mask block lengths 

DESX8: File is not on disk 
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ENQC JSYS 515 



Returns the current status of the given resource and obtains 
information about the state of the queues. This monitor call also 
allows privileged processes to manipulate access rights to the queues 
and to perform other utility functions on the queue structure. 

Refer to the TOPS-20 Monitor Calls User's Guide for an overview and 
description of the Enqueue/Dequeue facility. 

The ENQC monitor call has two calling sequences, depending on whether 
the process is obtaining status information or is modifying the queue 
structure . 

Obtaining Status Information 



RESTRICTIONS 



ACCEPTS IN AC1 
AC2 



RETURNS 



AC3 
+ 1 
+ 2 



some functions require WHEEL or OPERATOR capabilities 
enabled . 

When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

function code (.ENQCS) 

address of argument block 

address of block in which to place status 

failure, error code in AC1 

success 



The function .ENQCS returns the status of the specified resources. 

The argument block is identical in format to the ENQ and DEQ argument 
blocks. (Refer to the ENQ monitor call description.) 

The status block has a 3-word entry for each resource specified in the 
argument block. This entry reflects the current status of the 
resource and has the following format: 



17 1! 



35 



1 






flag 


bi 


ts 


ind 


icat 


ing 


status 


of 


resource 














36 
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time 


stamp 
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lock 
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ue 


st 


ID 



The following flag bits are currently defined. 

B0(EN%QCE) An error has occurred in the corresponding resource 
request and bits 18-35 contain an appropriate error 
code. 
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Bl(EN%QCO) This process owns the lock. 

B2 (EN%QCQ) This process is in the queue waiting for this 
resource. This bit is set if Bl (EN%QCO) is set 
because a request remains in the queue until a DEQ 
call is given. 

B3 (EN%QCX) The lock has been allocated for exclusive access. 

B4 (EN%QCB) This process is in the queue waiting for exclusive 
access to the resource. This bit is off if B2 (EN%QCQ) 
is off. 



B9-B17 
(EN%LVL) 

B18-B35 
(EN%JOB) 



The level number of the resource. 

Job number of the owner of the lock. For locks 
with shared access, this value will be the job number 
of one of the sharers. However, this value will be 
the current job's number if the current job is one of 
the sharers. If the lock is not owned, the value is 
-1. If B0(EN%QCE) is on, this field contains the 
appropriate error code. 

The time stamp indicates the last time a process was given access to 
the resource. The time is in the universal date-time standard. If no 
process currently has access to the resource, the word is zero. 

The number returned in the left half of the third word indicates the 
number of processes that currently have the resource locked for either 
exclusive access or shared access. 

The request ID is either the request ID of the current process if that 
process is in the queue, or the request ID of the owner of the lock. 

Modifying the Queue Structure 

RESTRICTIONS: When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



function code 

address of argument block 

failure, error code in AC1 

success 



The available functions, along with their argument block formats, are 
as follows: 



Function Argument Block 

.ENQCG One word containing 
a job number in the 
right half. The left 
half is ignored. 

.ENQCC One word containing 
the new quota in the 
left half and a job 
number in the right 
half. 



Meaning 

Return the ENQ/DEQ quota for 
the specified job. The quota 
is returned in AC1. 



Change the ENQ/DEQ quota for 
the specified job. The process 
executing the call must have 
WHEEL capability enabled or an 
error code is returned. 
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Function 



.ENQCD 



Argument Block 



Meaning 



A block of n words. Dump the ENQ/DEQ locks and 

The first word is the queue entries into the 

length of the block (n) . argument block. The process 

Remaining words contain executing the call must have 

the returned WHEEL capability enabled or an 

data. (See below.) error code is returned. 

The data returned in the argument block concerns both the ENQ/DEQ 
locks and the queues. The data concerning the locks is in a 4-word 
block of the following format: 



ENQDF 

ENQDR 

.ENQDT 

ENQDC 










8 9 






17 


18 










35 
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If there are no pooled resources, word .ENQDR has the format 



17 11 



•ENQDR 



group number 



35 



The data concerning the queues is in a 2-word block of the following 
format: 



.ENQDF 
.ENQDI 



8 9 17 18 35 

flags 'software chan! job # creator queue entry 
group # or number requested! request ID 



The flags returned in the first word of each block are as follows: 

B0(EN%QCL) This block concerns data about the locks. If this bit 
is off, the block concerns data about the queues. 

Bl(EN%QCO) This process owns the lock. 

B2(EN%QCT) This lock contains a text string. 

B3(EN%QCX) This lock is for exclusive access. 

B4(EN%QCB) This process is blocked until exclusive access is 
available. 
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ENQC ERROR MNEMONICS: 



ENQX1 

ENQX2 

ENQX3 

ENQX4 

ENQX5 

ENQX6 

ENQX7 

ENQX8 

ENQX9 

ENQX10 

ENQX11 

ENQX12 

ENQX13 

ENQX14 

ENQX15 

ENQX16 

ENQX17 

ENQX18 

ENQX19 

ENQX20 

ENQX21 

DESX8: 



Invalid function 

Level number too small 

Request and lock level numbers do not match 

Number of pool and lock resources do not match 

Lock already requested 

Requested locks are not all locked 

No ENQ on this lock 

Invalid access change requested 

Invalid number of blocks specified 

Invalid argument block length 

Invalid software interrupt channel number 

Invalid number of resources requested 

Indirect or indexed byte pointer not allowed 

Invalid! byte size 

ENQ/DEQ capability required 

WHEEL or OPERATOR capability required 

Invalid JFN 

Quota exceeded 

String too long 

Locked JFN cannot be closed 

Job is not logged in 

File is not on disk 
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Enables the capabilities for the specified process. (Refer to Section 
2.7.1 for a description of the capability word.) 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



process handle 

capabilities the process can enable 

capabilities to enable 

always 



The capabilities in bits 0-8 and bits 18-35 of AC2 are matched (ANDed) 
with the corresponding capabilities of both the calling process and 
the process specified in AC1. The calling process can only enable 
those capabilities that both the calling process and the object 
process have. 

The contents of AC2 are ignored if the process handle in AC1 is for 
the current process. 

The RPCAP monitor call can be used to obtain the capabilities of a 
process . 

Generates an illegal instruction interrupt on the following error 
conditions : 

EPCAP ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 
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Translates a TOPS--20 error number to its corresponding text string and 
writes the string to the specified destination. This error number is 
the one returned in an AC (usually in AC1) on a JSYS error and is 
associated with a unique error mnemonic and text string. The error 
numbers begin at 600010 and are defined in the system file MONSYM.MAC. 
(Refer to Appendix B for the list of error numbers, mnemonics, and 
text str ings . ) 



ACCEPTS IN AC1: 
AC2: 



RETURNS 



destination designator 

LH: process handle 

RH : error number, or -1 for the most recent error 
in the specified process. If an error number is 
specified, .FHSLF should be specified in the 
left half of AC2. 

AC3: LH : a negative count of the maximum number of bytes 
in the string to be transferred, or for no 
limit 
RH: 



+1: failure, undefined error number 

+2: failure, string size out of bounds or 
destination designator 

+3: success 



inval id 



Generates an illegal instruction interrupt on error conditions below. 

ERSTR ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

FRKHX1: Invalid process handle 



10X11 
10X34 
10X35 



Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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ESOUT JSYS 313 

Outputs an error string. This monitor call reports an error in the 
primary input stream, and resynchronizes the input transaction. This 
mechanism is convenient for communicating with a user who made a 
typing error and may have continued to type. It also allows error 
messages to have a standard format. 

ACCEPTS IN AC1: byte pointer to a string in the caller's address 
space. The string is terminated with a null 
character . 

RETURNS +1: always, with updated byte pointer in AC1 

The ESOUT call waits for the primary output buffer to empty and then 
outputs a carriage return, line feed, and question mark to the primary 
output designator. Next, it clears the primary input buffer and 
I outputs the error string to the primary output device. 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 
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Finds the first free page in the specified file. A free page is one 
that is marked as not being in use. The FFFFP call is useful for 
finding a nonused page in a file before a PMAP call is executed that 
writes into that page. 

ACCEPTS IN AC1: starting page number in left half, JFN in right half. 

RETURNS +1: always, with the JFN in the left half of AC1 and the 
page number in the right half of AC1, or a fullword 
-1 in AC1 if there is no free page. 

Generates an illegal instruction interrupt on the following error 
conditions : 

FFFFP ERROR MNEMONICS: 



DESX1 
DESX3 
DESX4 
DESX5 



Invalid source/destination designator 

JFN is not assigned 

Illegal use of terminal designator or string pointer 

File is not open 
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FFORK JSYS 154 

Freezes one or more processes. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always 

This suspends the processes (as soon as they are stoppable from the 
monitor's point of view) in such a way that they can be continued at 
the place they were suspended. However, they do not have to be 
continued; they could be killed. 

The FFORK call is ignored if the referenced process is already frozen. 

The RFORK monitor call can be used to resume one or more processes. 

Generates an illegal instruction interrupt on the following error 
conditions : 

FFORK ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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FFUFP JSYS 211 



Finds the first used page of the file at or beyond the specified page 
number . 



ACCEPTS IN AC1 



RETURNS 



+ 1 
+ 2 



JFN in the left half, and the starting page number in 
the right half 

failure, error code in AC1 

success, page number in the right half of AC1. The 
left half of AC1 is unchanged. 



FFUFP ERROR MNEMONICS: 



DESX1 

DESX3 

DESX4 

DESX7 

FFUFX1 

FFUFX2 

FFUFX3 



Invalid source/destination designator 

JFN is not assigned 

Illegal use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 

File is not open 

File is not on multiple-directory device 

No used page found 
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FLHST JSYS 277 

"Flushes" an ARPANET host. Causes the NCP tables containing that 
host's status information to be purged of all information regarding 
previous or partially terminated connections between the sending and 
receiving hosts of the connection. All connections to the flushed 
host are closed. 

RESTRICTIONS: for ARPANET systems only. Requires OPERATOR, WHEEL, 
or NET WIZARD capabilities enabled. 

ACCEPTS IN AC1: number of host to be flushed 

RETURNS +1: always 
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FLIN 



JSYS 232 



Inputs a floating-point number from the specified source. This call 
ignores leading spaces and terminates on the first character that 
cannot be part of a floating point number. If that character is a 
carriage return followed by a line feed, the line feed is also input. 



ACCEPTS IN AC1 
RETURNS +1 

+ 2 



source designator 

failure, error code in AC3 and updated string pointer 
in AC1, if pertinent 

success, single-precision, floating-point number in 
AC2 and updated string pointer in AC1 , if pertinent 



FLIN ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX5: file is not open 

FLINX1: first character is not blank or numeric 

FLINX2: number too small 

FLINX3: number too large 

FLINX4: invalid format 
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FLOUT JSYS 233 

Outputs a floating-point number to the specified destination 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



destination designator 

normalized, single-precision, floating-point number 

format control word. (Refer to Section 2.9.1.2.) 

failure, error code in AC3 and updated string pointer 
in AC1, if pertinent 



+2: success, updated string pointer in AC1, if pertinent 
FLOUT ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 
DESX2: Terminal is not available to this job 
DESX3: JFN is not assigned 
DESX4: File is not open 

FL0TX1: Column overflow in field 1 or 2 
FL0TX2: Column overflow in field 3 
FL0TX3: Invalid format specified 
10X11: Quota exceeded 
10X34: Disk full 
10X35: Unable to allocate disk - structure damaged 
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GACCT JSYS 546 

Returns the current account for the specified job. 

RESTRICTIONS: some functions require Confidential Information 
Access, WHEEL, or OPERATOR capabilities enabled. 

ACCEPTS IN AC1: job number, or -1 for current job 

AC2: byte pointer to string where alphanumeric account 
designator (if any) is to be stored 

RETURNS +1: always, with updated pointer to account string in AC2 

The GACCT monitor call requires the process to have Confidential 
Information Access, WHEEL, or OPERATOR capability enabled if the 
specified job number is not for the current job. 

The CACCT monitor call can be used to change the account for the 
current job. 

Generates an illegal instruction interrupt on the following error 
conditions : 

GACCT ERROR MNEMONICS: 



GACCX1 
GACCX2 
GACCX3 



Invalid job number 

No such job 

Confidential Information Access capability required 
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GACTF JSYS 37 



Returns the account designator to which the specified file is being 
charged . 



ACCEPTS IN AC1 



JFN 



AC2: byte pointer to string in caller's address space 
where account string (if any) is to be stored 

RETURNS +1: failure, error code in AC1 

+2: success, account string returned, updated string 
pointer in AC2 

+3: success, 5B2+account number returned in AC2 

The SACTF monitor call can be used to set the account designator to 
which the file is to be charged. 

GACTF ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX4 

DESX7 

GACTX1 

GACTX2 

GACTX3 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 

File is not on multiple-directory device 

File expunged 

Internal format of directory is incorrect 
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GCVEC JSYS 300 



Returns the entry vector and the UUO locations for the compatibility 
package . 



ACCEPTS IN AC1 
RETURNS +1 



process handle 

always, with entry vector length in the left half and 
entry vector address in the right half of AC2, and 
UUO location in the left half and PC location in the 
right half of AC3. 

If use of the compatibility package has been disabled, AC2 contains -1 
on return. If the compatibility package is not available, AC2 and AC3 
contain on return. 

The SCVEC monitor call can be used to set the entry vector for the 
compatibility package. 

GCVEC ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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GDSKC JSYS 214 

Returns information on the given structure's disk usage and 
availability. This call. is useful in determining storage usage. 

ACCEPTS IN AC1: device designator, must be a designator for a 
structure. If the generic designator DSK: is given, 
the connected structure is assumed. 

RETURNS +1: always, with number of pages in use in AC1, and 
number of pages not in use in AC2. 

GDSKC ERROR MNEMONICS: 

DEVX1: Invalid device designator 
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GDSTS JSYS 145 



Returns the status of a device for user I/O. (Refer to Section 2.4 
for the descriptions of the status bits.) This call requires that the 
device be opened. 

Also, this call will not return the status of a device for monitor 
I/O. For example, if GDSTS is executed after a tape mark is written 
(a monitor I/O operation) the GDSTS call will return the status of the 
last user record written. 

ACCEPTS IN AC1: JFN 

RETURNS +1: always, with device-dependent status bits in AC2, and 
device-dependent information in AC3. For magnetic 
tape, AC3 contains the positive count of number of 
hardware bytes actually transferred in the left half 
and zero in the right half. For the line printer, 
AC3 contains the last value of the page counter 
register, or -1 if there is no page counter register. 

For ARPANET, the return sequence for network-connection files is: 

AC2: connection state (octal values 01 thru 16) in bits 
thru 3 

AC3: foreign host number (octal) 

AC4: foreign socket number (octal) 

The GDSTS call is a no-op for devices without device-dependent status 
bits . 

The SDSTS monitor call can be used to set the status bits for a 
particular device., 

Generates an illegal instruction interrupt on error conditions below. 

GDSTS ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 
DESX5 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 
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GDVEC JSYS 542 

Returns the entry vector for the Record Management System (RMS) . 

RESTRICTIONS: Requires RMS software (currently available only with 
BASIC and COBOL) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with entry vector length in the left half and 
the entry vector address in the right half of AC2. 

The SDVEC monitor call can be used to set the entry vector for RMS. 

Generates an illegal instruction interrupt on error conditions below. 

GDVEC ERROR MNEMONICS: 

ILINS5: RMS facility is not available 
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GET JSYS 200 

Gets a save file, copying or mapping it into the process as 
appropriate. It updates the monitor's data base for the process by 
copying the entry vector and the list of program data vector addresses 
(PDVA's) from the save file. (See the .POADD function of the PDVOP% 
monitor call . ) 

This call can be executed for either sharable or nonsharable save 
files that were created with the SSAVE or SAVE monitor call, 
respectively. The file must not be open. 

ACCEPTS IN AC1: process handle,, flag bits and a JFN 

AC2: lowest process page number in left half, and highest 
process page number in right half; or the address of 
an argument block. If this AC contains page numbers, 
those page numbers control the parts of memory that 
are loaded when GT%ADR is on. 

RETURNS +1: always 

The defined bits in AC1 are as follows: 

Bit Symbol Meaning 

19 GT%ADR Use the memory address limits given in AC2. 

If this bit is off, all existing pages of the 
file (according to its directory) are mapped. 

20 GT%PRL Preload the pages being mapped (move the 

pages immediately.) If this bit is off, the 
pages are read in from the disk when they are 
referenced . 

21 GT%NOV Do not overlay existing pages and do return 

an error. If this bit is off, existing pages 
will be overlaid. 

22 GT%ARG If this bit is on, AC2 contains the address 

of an argument block. 

24-35 GT%JFN JFN of the save file 
The format of the argument block follows: 

Word Symbol Meaning 

.GFLAG Flags that indicate how the rest of the 

argument block is to be used. 

1 .GLOW Number of the lowest page in the process into 

which a file page gets loaded. This page 
must be within the section specified by 
.GBASE. 

2 .GHIGH Number of the highest page in the process 

into which a file page gets loaded. This 
page must be within the section specified by 
.GBASE. 
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Word Symbol Meaning 

3 .GBASE Number of the section into which the file 

pages are loaded. You can specify the 
section for single-section save files only; 
use of this word with a multiple-section save 
file causes an error. The file pages are 
loaded into this section of memory regardless 
of the section specified in the save file. 

The following flag bits are defined for use in .GFLAG: 

Bit Symbol Meaning 

GT%LOW .GLOW contains the number of the lowest page 

within the process to use. 

1 GT%HGH .GHIGH contains the number of the highest 

page within the process to use. 

2 GT%BAS .GBASE contains the number of the section to 

use . 

3 GT%CCH Clear the system's program cache. (Operator 

or wheel privileges are required for use of 
this bit. ) 

4 GT%CSH Place in cache the name of the program being 

loaded into memory. (Operator or wheel 
privileges are required for use of this bit.) 

When the GET call is executed for a sharable save file, pages from the 
file are mapped into pages in the process, and the previous contents 
of the process' page are overwritten. If the file contains data for 
only a portion of the process' page, the remainder of the page is 
zeroed. Pages of the process not used by the file are unchanged. 

When the GET call is executed for a nonsharable save file, individual 
words of the file are written into the process. Since these files 
usually do not have words containing all zeros, a GET call executed 
for a nonsharable file never clears memory. The GET call never loads 
the accumulators. 

The GET JSYS interacts with the JFN of the file that the GET is 
performed upon in the following ways: 

1. If the GET is performed on a CSAVE file, a file on a non-disk 
device, or a file that has another JFN open on it, the JFN is 
released . 

2. Under normal conditions for a file with only one JFN open on 
it, if the GET succeeds, it will eventually cause an implicit 
CLOSF for the file on which the GET was performed. This 
occurs through the following mechanism: GET changes the 
owner of the file from the process that issued the GET to the 
process into which the file is mapped. When the latter 
process is killed, the JFN is released. 
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Because a program can not be sure that GET has or has not released the 
JFN, the program should not attempt to release the JFN itself or 
attempt to use the JFN again (assuming that the GET actually 
succeeded). At the time that a program tried to erroneously release 
the JFN itself, the JFN might be associated with a file other than the 
file on which the GET was performed. This can be a source of program 
errors that are difficult to trace. 



This call can cause several software 
terminations on some file conditions. 



interrupts or process 



A GET call performed on an execute-only process is illegal unless the 

process is .FHSLF. If the JFN specified in the GET call refers to a 

file for which the user only has execute-only access, then the process 
specified must be a virgin process. 



Generates an illegal instruction interrupt 
conditions : 

GET ERROR MNEMONICS: 



on 



the following error 



FRKHX1 

FRKHX2 

FRKHX3 

FRKHX8 

GETX1 

GETX2 

GETX3 

GETX4 

SSAVX1 

0PNX2: 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 

Invalid save file format 

System Special Pages Table full 

Illegal to overlay existing pages 

Illegal to specify .GBASE for multisection file. 

Illegal to save files on this device 

File does not exist 



All file errors can occur 
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GETAB JSYS 10 



Returns a word from the specified system table. 
2.3.2. ) 



(Refer to Section 



ACCEPTS IN AC1 



RETURNS 



+ 1 
+ 2 



index into table in the left half, and table number 
in the right half 

failure, error code in AC1 

success, 36-bit word from the specified table in AC1 



If -1 is given as the index, this call returns the negative of the 
length of the specified table. 

The table number can be obtained with the SYSGT call. However, the 
recommended procedure is to use the symbol definition from the MONSYM 
file for the table number. (Refer to Appendix B for the system table 
definitions . ) 

The GETAB monitor call requires the process to have GETAB capability 
available, but not enabled (SC%GTB in the process capability word). 

GETAB ERROR MNEMONICS: 



GTABX1 
GTABX2 
GTABX3 



Invalid table number 
Invalid table index 
GETAB privileges required 
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GETER JSYS 12 

Returns the most recent error condition encountered in a process. The 
most recent error is always saved in the Process Storage Block. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with process handle in left half of AC2 and 
most recent error condition in right half of AC2. 

The SETER monitor call can be used to set the most recent error 
condition encountered in a process. 

GETER ERROR MNEMONICS: 

LSTRX1: Process has not encountered any errors 
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GETJI JSYS 507 

Obtains information about the specified job. 

ACCEPTS IN AC1: job number, or -1 for current job, or 400000+TTY 
number 

AC2: negative of the length of the block in which to store 
the information in the left half, and the beginning 
address of the block in the right half 

B .C3: word number (offset) of first entry desired from job 
information table 

RETURNS +1 : failure, error code in AC1 

+2: success, with updated pointer in AC2 and requested 
entries stored in specified block 

When a terminal designator is given in AC1, the information returned 
is for the job running on that terminal. 

The system begins copying the entries from the job information table, 
starting with the offset given in AC3, into the address specified in 
the right half of AC2. The number of entries copied is minus the 
number given in the left half of AC2, or is the number remaining in 
the table, whichever is smaller. 

Because AC2 is updated on a successful return, it cannot be used for 
the returned data. 

The format of the job information table is as follows: 

Word Symbol Meaning 

Job number 

Job's terminal number (-1 means the job is 

detached) 

Job's user number 

Job's connected directory number 

Subsystem name (SIXBIT) 

Program name (SIXBIT) 

Run time (in milliseconds) 

Controlling PTY job number (-1 means the job 

is not controlled by a PTY) 

Run time limit (as set by the TIMER call) 

A zero means no time limit is in effect. 

Job is controlled by Batch, if -1 (as set by 

the MTOPR call) 

Default for magnetic tape density (as set by 

the SETJB call) 

Default for magnetic tape parity (as set by 

the SETJB call) 

Default for magnetic tape data mode (as set 

by the SETJB call) 

Default number for magnetic tape record size 

in bytes (as set by the SETJB call) 

Deferred spooling in effect, if 1 (as set by 

the SETJB call) 





1 


.JUNO 
.JITNO 


2 
3 
4 
5 
6 
7 


.JIUNO 

.JIDNO 

.JISNM 

.JIPNM 

.JIRT 

.JICPJ 


10 


. JIRTL 


11 


. JIBAT 


12 


. JIDEN 


13 


. JIPAR 


14 


. JIDM 


15 


. JIRS 


16 


. JIDFS 
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Word 



Symbol 



17 


. JILNO 


20 


. JISRM 


21 


. JILLN 


22 


. JISRT 



23 

24 
25 

26 



27 



. JISCT 

. JIT20 
. JISTM 

. JIBCH 



Meaning 

Job's logged-in directory number 

Byte pointer to area to receive job's session 

remark. This pointer is supplied by the user 

before issuing the GETJI call. 

The date and time of the user's last login 

before the user logged in the current job 

Job CPU time at start of last session. To 

compute CPU time for this session, subtract 

.JISRT value from current job CPU time 

( . JIRT) . 

Console time at start of last session. To 

compute the console time for this session, 

subtract .JISCT value from current console 

time (obtainable with RUNTM monitor call). 

Indicates if job is at EXEC level or program 

level. (-1 = EXEC, = program) 

Returns time when job was created (when 

CTRL/C was performed) . -1 is returned if the 

system time and date were not set when the 

job started. 

Batch stream number and batch flags 



Field 



3B1 



Symbol Contents 

OB%WTO Wr ite-to-operator 
capabilities 



Value Symbol 



1B10 



177B17 







I 
2 

OB%BSS 



OB%BSN 



,OBALL 



OBNWR 
OBNOM 



Meaning 

WTO (write to 
operator) and WTOR 
(write to operator 
with reply) 
No WTOR allowed 
No message allowed 



Indicates that field 
OB%BSN (below) contains a 
batch-stream number 
Batch-stream number 



. JILLO 



Logical location (node name) This word 
indicates the logical location of the job. 
This job location is typically used to cause 
output to be routed to a remote station, such 
as an IBM termination station or a DN200 
remote station. 



The current highest GETJI offset is given by symbol .JIMAX. 
GETJI ERROR MNEMONICS: 



GTJIX1 
GTJIX2 
GTJIX3 
GTJIX4 



Invalid index 

Invalid terminal line number 

Invalid job number 

No such job 
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GETNM JSYS 177 

Returns the name of the program currently being used by the job. This 
name will have been declared previously with the SETNM or SETSN 
monitor call. 

RETURNS +1: always, with SIXBIT name of program in AC1 
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GETOK% JSYS 574 

Requests access to the specified system resource from the 
installation's access-control program. 

ACCEPTS IN AC1: function code 

AC2: address of argument block (if required) 

AC3: length of the argument block (the maximum permissible 
length is specified by symbol .GOKMZ) 



AC4 



job number or user number request is for 



RETURNS 



Function Codes 

Code Symbol 



+1: always, with in first word of status block if 
access granted 

1B18 set to one + error number in first word of 
status block if request denied. An illegal 
instruction trap is generated. 



1 



GOASD 



.GOCAP 



.GOCJB 



.GOLOG 



Meaning 
Assign a device 

Argument block (user-specified): 
Word Symbol Contents 

.GEERB Error block address 

1 .GEADD Device designator 

Enable capabilities (right half privileges 
only) 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 

1 .GENCP New capability word 

Allow CRJOB JSYS to be executed 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 
Allow LOGIN 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 

1 .GELUN User number 
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Code 
5 



10 



11 



Symbol Meaning 

.GOCFK Allow CFORK (only done after n ' th fork). N 
is an installation-defined parameter 
specified by monitor symbol DGOFKN. 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 

1 .GEFCT Number of forks already in 

use by job 

.GOTBR Set terminal baud rate 

Argument block (user-specified): 
Word Symbol Contents 

.GEERB Error block address 

1 .GELIN Line number 

2 .GESPD Input speed ,, Output speed 

.GOLGO Inform the access-control program of a 
logout . 

Argument block (user-specified): 

Word Symbol Contents 



Error block address 

Number of pages used 

Directory quota 

Number of the job to be 

logged out, or -1 if the 

requesting job is to be 

logged out. 



GOENQ Allow setting of ENQ quota 

Argument block (user-specified): 
Word Symbol Contents 

.GEERB Error block address 

1 .GEEQU Desired quota 

2 .GEEUN Job number 

.GOCRD Allow directory creation 

Argument block (user-specified): 
Word Symbol Contents 
.GEERB Error block address 






.GEERB 


1 


.GEUSD 


2 


.GEQUO 


3 


.GERLG 
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Code 
12 



Symbol 
.GOSMT 



13 



GOMDD 



14 



.GOCLS 



15 



.GOCLO 



16 



. GOMTA 



Meaning 

Allow MOUNT of structure 

Must be given once to increment the mount 
count and once to decrement the mount count. 

Argument block (user-specified).: 

Word Symbol Contents 

.GEERB Error block address 

1 .GESDE Device designator 

Allow entry to MDDT 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 
Set scheduler class for a job 
Argument block (user-specified): 
Word Symbol Contents 



.GEERB 

1 .GEJOB 

2 .GECLS 



Error block address 
Job number 
Class desired 



Set scheduler class at login 

This function is executed by the monitor when 
a login occurs and class scheduling is 
enabled (but not by accounts) . The 
access-control program must then determine 
which class to put the user in. 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 

MT: access request 

Argument block (user-specified): 

Word Symbol Contents 



Error block address 

Access code from HDR1 label 

User number 

MT: unit number 

Desired access bits (FP%xxx) 

Label type (.LTxxx) 






.GEERB 


1 


.GEACC 


2 


.GEUSN 


3 


.GEUNT 


4 


.GEACD 


5 


.GELTP 
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Code Symbol Meaning 

17 .GOACC Allow ACCESS or CONNECT 

Argument block (user-specified): 

Word Symbol Contents 

.GEERB Error block address 

1 .GOACO Flags from ACCES JSYS 

2 .GOAC1 Directory number 

20 .GOOAD Allow device assignment due to OPENF 

Argument block (user-specified): 
Word Symbol Contents 

.GEERB Error block address 

1 .GEADD Device designator 

21 .GODNA Allow access to DECNET 

Argument block (user-specified): 
Word Symbol Contents 
.GEERB Error block address 

22 .GOANA Allow ARPANET access 

Argument block (user-specified): 

Word Symbol Contents 
.GEERB error block address 
2 3 .GOATJ Allow ATTACH 

Argument block (user-specified): 

Word Symbol Contents 

.GOTJB Target job number 

1 .GEADD Source TTY number 

400000+n Customer-reserved functions 

The argument block (user-specified) has the 
same format as the error block format shown 
below. The contents of word 1 are ignored. 
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Error block format (returned) 



Word 

(.GESIZ) 

1 (.GEERN) 
2 (.GEPTR) 
3 ( .GEBSZ) 



Contents 

Count of words in this block (including this 
word) 

Error Number 

Byte pointer to error string location 

Maximum bytes user can accept in error string 



The format of the status block for user-defined functions will depend 
on the design of the particular access-control program. 

The user supplies all arguments in the argument block. In the error 
block, the user supplies words 0, 2, and 3. If an error string is 
provided by the program doing the GIVOK%, then the byte pointer and 
count are updated. If the user is not interested in the reason for 
the rejection, the address of the error block can be 0. If the error 
block is less than 4 words, only the available words will be used. If 
the byte pointer is 0, no string will be returned. 

Error codes are of the form lB18+n. They are not standard TOPS-20 
error codes and! therefore cannot be given to ERSTR to produce a 
string. The access-control program must supply a string if one is 
needed . 

Generates an illegal instruction interrupt on the following error 
conditions : 

GETOK% ERROR MNEMONICS: 



ARGX0 4 
ARGX05 
ARGX26 
MONX01 
GOKER1 
GOKER2 



Argument block too small 

Argument block too long 

File is offline 

Insufficient system resources 

Illegal function 

Request denied by Access Control Facility 
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GEVEC JSYS 205 

Returns the section-relative entry vector of the specified process. 
(Refer to Section 2.7.3.) The process must be one that runs in a 
single section of memory. See the XGVEC% monitor call to obtain the 
entry vector of a multisection program. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with specified process' entry vector word in 
AC2 

The SEVEC monitor call can be used to set the process 1 entry vector. 
(Refer to the PDV0P% monitor call for a description of the program 
data vector . ) 

Generates an illegal instruction interrupt on the following error 
conditions : 

GEVEC ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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GFRKH JSYS 164 



Gets a handle on a process that currently is not known to the caller 
but is known to another process. The handle returned can then be used 
by the caller to refer to the process of interest. 



ACCEPTS IN AC.1: handle of the process that has a 
process of interest 



handle on the 



AC2: process handle, used by the process named in AC1, 
that refers to the process of interest. This handle 
must be a relative handle (in the range 400000 to 
400777) and must refer to an existing process. 



RETURNS 



+ 1 : failure, with error code in AC1. 

+2: success, with a handle in AC1 that is usable by the 
caller to refer to the desired process. This handle 
is not the same as the one given in AC2 (is different 
from the one used by the process in AC1 to refer to 
the desired process) . 

Generates an illegal instruction interrupt on error conditions below. 

GFRKH ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX6 
GFRKX1 



Invalid process handle 

Illegal to manipulate a superior process 
Invalid use of multiple process handle 
All relative process handles in use 
Invalid process handle 
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GFRKS JSYS 166 



Returns the process structure of the current job from a given process 
downward . 



RESTRICTIONS: 
ACCEPTS IN AC1 
AC2 



RETURNS 



some functions require WHEEL or OPERATOR capability 

process handle of the starting point 

B0(GF%GFH) return relative process handles for each 
process 

B1(GF%GFS) return status for each process 

AC3: the left half contains the negative of the number of 
words in the block in which to store the process 
structure, and the right half contains the address of 
the first word of the block 

+1: failure, error code in AC1 

+2: success, all process handles are returned 



The handle of the current process is always returned as .FHSLF 
regardless of the setting of GF%GFH. Any user can specify a process 
handle of . FHTOP (causing GFRKS to start with the top level process). 
However, the user must have WHEEL or OPEPATOR capability enabled to 
specify .FHTOP, set GF%GFH and receive relative handles for all 
processes from .FHTOP on down. Otherwise, only process handles that 
the issuing process is entitled to receive will be returned. Also, if 
the request will cause the monitor to exceed the per-process fork 
handle limit, only that number of handles that will fit within the 
limit will be returned. 



Table format 



3 words 
per entry 



This word is 
-1 if GF%GFS 
is off. 



! parallel 
! pointer 


! inferior ! 
! pointer ! 


! superior 
! pointer 


! process handle ! 
! or if GF%GFH ! 
! was off, or when no ! 
! more process handles ! 
! are left for the ! 
! process ! 




status word ! 
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NOTE 

Pointers in table are memory addresses 
of other table entries, or if no such 
structure exists. 



The execution of the GFRKS call terminates before the entire process 
structure has been returned if the block in which to store the 
structure information is too small. If this happens, this call 
returns as much of the structure as can fit in the block, then 
generates an error message. If all process handles are in use, this 
call returns the entire structure, but the extra handles will not be 
assigned (will be zero) . 

Generates an illegal instruction interrupt on error conditions below. 

GFRKS ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX6 
GFKSX1 



Invalid process handle 

Illegal to manipulate a superior process 
Invalid use of multiple process handle 
All relative process handles in use 
Area too small to hold process structure 
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(GFUST) 

GFUST JSYS 550 



Returns the name of either the author of the file or the user who last 
wrote to the file. 

ACCEPTS IN AC1: function code in the left half, and JFN of the file 
in the right half 

AC2: pointer to the string in which to store the name 

RETURNS +1: always, with an updated string pointer in AC2 

The defined functions are as follows: 

Code Symbol Meaning 

.GFAUT Return the name of the author of the file. 

1 .GFLWR Return the name of the user who last wrote to the 

file. 

The SFUST monitor call can be used to set the name of either the 
author of the file or the user who last wrote to the file. 

Generates an illegal instruction interrupt on error conditions below. 

GFUST ERROR MNEMONICS: 



GFUSX1 

GFUSX2 

GFUSX3 

GFUSX4 

DESX1 

DESX2 

DESX3 

DESX4 

DESX5 

DESX7 

DESX8 

DESX10: 

DELFX6: 

DIRX2: 

DIRX3: 



Invalid function 

Insufficient system resources 

File expunged 

Internal format of directory is incorrect 

Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 

Illegal use of parse-only JFN or output wildcard-designators 

File is not on disk 

Structure is dismounted 

Internal format of directory is incorrect 

Insufficient system resources 

Internal format of directory is incorrect 
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GIVOK% JSYS 576 

Allows a privileged access-control program (written by the 
installation) to allow or disallow a user program's access to a 
specified system resource. 

RESTRICTIONS: Requires enabled WHEEL or OPERATOR capability. 

ACCEPTS IN AC1: Request number (from RCVOK% message) 

AC2: = request granted 

1B18 + error number = request denied 

AC3: pointer to ASCIZ string (maximum of 80 characters) or 
0. This string is an error message or information 
message to be returned to the user. 

RETURNS +1: always 

Generates an illegal instruction interrupt on error conditions below. 

GIVOK% ERROR MNEMONICS: 

CAPX1: WHEEL or OPERATOR capability required 

GOKER3: JSYS not executed within ACJ fork 



3-167 



TOPS-20 MONITOR CALLS 
(GJINF) 

GJINF JSYS 13 

Returns information pertaining to the current job. 

RETURNS +1: always, with 

AC1 containing the user number under which the job is 
running . 

AC2 containing the directory number to which the job is 
connected . 

AC3 containing the job number. 

AC4 containing the terminal number attached to the job, 
or -1 if no terminal is attached to job. 
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GNJFN JSYS 17 



Assigns the JFN to the next file in a group of files that have been 
specified with wildcard characters. The next file in the group is 
determined by searching structures and directories in the order 
described in Section 2.2.3. The flags returned from the GTJFN call 
are given to the GNJFN call as an argument to indicate the fields of 
the file specification that contain wildcard characters. 



ACCEPTS IN AC1 



RETURNS 



+ 1 



+ 2 



indexable file handle returned by GTJFN (i.e., flags 
returned by GTJFN in the left half and the JFN in the 
right half) 

failure, including no more files in the group. JFN 
is released if there are no more files in the group. 
This return occurs on the first call to GNJFN if no 
flags indicating wildcard fields are on in the left 
half of AC1. 

success, same JFN is assigned to the next file in the 
group. The following flags are set (if appropriate) 
in the left half of AC1: 

B13 GN1STR structure changed 

B14 GN%DIR directory changed 

B15 GN%NAM name changed 

B16 GN%EXT file type changed 

The GNJFN call uses the flags returned in the left half of AC1 on a 
GTJFN call to determine the fields containing wildcards and the 
default generation number. Note that the GNJFN call returns a 
different set of flags in the left half of AC1 than the GTJFN call 
returns. Because all calls to GNJFN should use the flags originally 
returned by GTJFN, programs must save the returned GTJFN flags for use 
in the GNJFN call. 

The file currently associated with the JFN must be closed when the 
GNJFN call is executed. 

GNJFN will not find invisible files unless bit G1%IIN was set in the 
GTJFN call. 

GNJFN ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX4 

GNJFX1 

OPNX1: 

STRX09 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

No more files in this specification 

File is already open 

Prior structure mount required 



3-169 



TOPS-20 MONITOR CALLS 
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GPJFN JSYS 206 

Returns the primary JFNs of the specified process. 

ACCEPTS IN AC1: process handle 

RETURNS +1 : always, with primary input JFN in the left half of 
AC2, and the primary output JFN in the right half of 
AC2. 

The SPJFN monitor call can be used to set the primary JFNs. If this 
call has not been given, the GPJFN call returns -1 in AC2. 

Generates an illegal instruction interrupt on error conditions below. 

GPJFN ERROR MNEMONICS: 

FRKHXl: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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(GTAD) 

GTAD JSYS 227 

Returns the current date in the internal system format. (Refer to 
Section 2.9.2.) 

RETURNS +1: always, with day in the left half of AC1, and 
fraction of day in right half of AC1 

If the system does not have the current date set, AC1 contains -1. 

The STAD monitor call can be used to set the system's date. 
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(GTDAL) 

GTDAL JSYS 305 

Returns the disk allocation for the specified directory. 

ACCEPTS IN AC1: directory number (-1 indicates the connected 
directory) 

RETURNS +1: always, with 

AC1 containing the working disk storage limit (logged-in 
quota) for the directory. 

AC2 containing the number of pages being used. 

AC3 containing the permanent disk storage limit 
(logged-out quota) for the directory. 

Generates an illegal instruction interrupt on error conditions below. 

GTDAL ERROR MNEMONICS: 

DIRX1: Invalid directory number 

DELFX6: Internal format of directory is incorrect 
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ACCEPTS 


IN 


AC1 
AC2 

AC3 


RETURNS 




+ 1 



TOPS-20 MONITOR CALLS 
(GTDIR) 

GTDIR JSYS 241 

Returns information about the given directory. 

RESTRICTIONS: some functions require WHEEL or OPERATOR capabilities 
enabled . 

directory number (36-bit) 

address of argument block in caller's address space 
in which to return the directory information 

byte pointer to the password string 

always, with updated byte pointer in AC3 

The argument block returned to the caller has the same format as the 
CRDIR call's argument block. Note, however, that not all the 
information that must be provided to the CRDIR call is returned by the 
GTDIR all. Argument block word 17 (.DCADC), for example, can contain 
the directory's default account for the CRDIR call, but GTDIR returns 
zero in that word. 

Word zero (.CDLEN) of the argument block must contain the length of 
the argument block in which GTDIR is to store the directory 
information being returned. If this word is zero, GTDIR assumes the 
length of the argument block is 15 (octal) words long. 

The password of the directory must be placed in the string to which 
AC3 points. Word I(.CDPSW) of the returned argument block also points 
to this string. 

The count of words to be returned in the user group list is given in 
word 14 (.CDDGP) of the argument block. This count must be one more 
than the number of words to be returned in the group list. This is 
because GTDIR returns a zero word as the last word in the group list. 

If the directory number given is zero, the GTDIR monitor call returns 
the system default settings for the following directory parameters: 

working disk storage quota (.CDLIQ) 

permanent disk storage quota (.CDLOQ) 

default file protection (.CDFPT) 

default directory protection (.CDDPT) 

default file retention count (.CDRET) 

maximum number of subdirectories allowed (.CDSDQ) 

online expiration period (.CDDNE) 

offline expiration period (.CDDFE) 

Either one of the following conditions must be satisfied for the 
caller to obtain all information (including the password) about the 
given directory. 

1. The caller has WHEEL or OPERATOR capability enabled. 

2. The caller has owner access to the directory. 

To obtain all information other than the password of the given 
directory, the caller must have at least owner access to the 
directory. (Refer to Section 2.2.6 for a description of owner 
access . ) 
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TOPS-20 MONITOR CALLS 
(GTDIR) 



Generates an illegal instruction interrupt on error conditions below, 
GTDIR ERROR MNEMONICS: 



GTDIX1 
GTDIX2 
MSTX32 



WHEEL or OPERATOR capability required 
Invalid directory number 
Structure was not mounted 
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TOPS-20 MONITOR CALLS 
(GTFDB) 

GTFDB JSYS 63 



Returns some or all of the file descriptor block for the specified 
file. (Refer to Section 2.2.8 for the format of this block.) 



ACCEPTS IN AC1: 
AC2 

AC3: 



JFN 

number of words to be read in the left half and the 
word number (offset) of the first entry desired from 
the file descriptor block in the right half. 

address in caller's address space for storing the 
data returned 



RETURNS +1: always 

The following instruction will set up AC2 for reading the entire FDB: 

HRLZI AC2,.FBLEN 

The program receives an error (GFDBX2) if it requests more words than 
there are words remaining in the FDB. For TOPS-20 V4 , the size of the 
FDB has been increased. If the left half of AC2 contains the current 
maximum size of the FDB (i.e., .FBLEN), but the FDB is an older, small 
FDB, then the extra words will contain zeroes. 

See Section 2.2.8 for the various JSYS ' s used to modify the FDB. 

Generates an illegal instruction interrupt on error conditions below. 

GTFDB ERROR MNEMONICS: 

GFDBXl: Invalid displacement 

GFDBX2: Invalid number of words 

GFDBX3: List access required 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX7: Illegal use of parse-only JFN or output wildcard-designators 
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TOPS-20 MONITOR CALLS 
(GTHST%) 

GTHST JSYS 273 



Obtains information about ARPANET hosts. 
RESTRICTIONS: for ARPANET systems only 

function code 

function-specific argument 

function-specific argument 

function-specific argument 

failure, error code in AC1 

success, function-specific data returned in AC ' s 

Function 

Returns negative number of host names, negative 
length of HSTSTS table, and local host number. 

User-supplied arguments: 

None 

Returned data: 



ACCEPTS 


IN AC1: 




AC2: 




AC3: 




AC4: 


RETURNS 


+ 1: 




+ 2: 


Code 


Symbol 





.GTHSZ 



AC2 
AC3 
AC4 



-number host names,, 

-length of HSTSTS table,, 

local host number (in 32-bit Internet 

format) 



.GTHIX 



Returns the name string associated with the host, 
the host number, and the host status. If the name 
returned is a nickname, HS%NCK is on in the status 
word . 

User-supplied arguments: 

AC2: destination byte pointer 

AC3: index into name table (returned by GETAB) 

Returned data: 



AC2 
AC3 
AC4 



updated byte pointer 
host number 
host status 



.GTHNS 



Returns the primary name for the given host number. 

User-supplied arguments: 

AC2: destination byte pointer 
AC3: host number 

Returned data: 



AC2 
AC3 
AC4 



updated byte pointer 
host number 
host status 
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Code 
3 



Symbol 
.GTHSN 



GTHHN 



GTHHI 



TOPS-20 MONITOR CALLS 
(GTHST%) 



Function 



Translates the specified host name string to its 
host number. If the name specified is a nickname, 
HS%NCK will be on in the status word. 

User-supplied arguments: 

AC2: source byte pointer 

Returned data: 



AC2 
AC 3 
AC4 



updated byte pointer 
host number 
host status 



Returns the current status of the given host 
User-supplied arguments: 
AC3: host number 
Returned data: 



AC3 
AC4 



host number 
host status 



Returns the host number and status of the host 
having the specified index into the host status 
table. 

User-supplied arguments: 

AC3: index into HSTSTS (returned by GETAB) 

Returned data: 







AC3: host number 






AC4: host status 


Flags in host stat 


us word: 


Bits 


Symbol 


Meaning 


1B0 


HS%UP 


Host is up 


1B1 


HS%VAL 


Valid status 


7B4 


HS%DAY 


Day when up if currently down 


37B9 


HS%HR 


Hour 


17B13 


HS%MIN 


5 minute interval 


17B17 


HS%RSN 


Reason 


1B18 


HS%SRV 


Host is server 


1B19 


HS%USR 


Host is user 


1B20 


HS%NCK 


Nickname 


77B26 


HS%STY 


System type mask 


1B27 


HS%NEW 


PAS, RAP, RAP, etc 
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TOPS-20 MONITOR CALLS 
(GTHST%) 



System Type Flags (HS%STY) 
Bits Symbol Meaning 



1B26 


•HS10X 


TENEX 


2B26 


.HSITS 


ITS 


3B26 


.HSDEC 


TOPS-10 


4B26 


.HSTIP 


TIP 


5B26 


.H.SMTP 


MTIP 


6B26 


.HSELF 


ELF 


7B26 


.HSANT 


ANTS 


L0B26 


•HSMLT 


MULTICS 


L1B26 


.HST20 


TOPS-20 


L2B26 


.HSUNX 


UNIX 



GTHST% ERROR MNEMONICS 



ARGX0 2 
GTHSX1 
GTHSX2 
GTHSX3 
GTJIX1 



Invalid function 

Unknown host number 

No number for that host name 

No string for that host number 

Invalid index 
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TOPS-20 MONITOR CALLS 
(GTJFN Short Form) 

GTJFN JSYS 20 

Returns a JFN for the specified file. Accepts the specification for 
the file from a string in memory or from a file, but not from both. 

ACCEPTS IN AC1: GJ%SHT plus other flag bits in the left half, and 
default generation number in the right half 

AC2: source designator from which to obtain the file 
specification. (Refer to flag bit GJ%FNS for 
specific values.) 

RETURNS +1: failure, error code in AC1 

+2: success, flags in the left half of AC1 , and the JFN 
assigned in the right half of AC1. (This word is 
called an indexable file handle and is given to the 
GNJFN call as an argument.) Updated string pointer in 
AC2, if pertinent. 

All I/O errors can occur. These errors cause software interrupts or 
process terminations, and only a single return (+1) is given. 

The string can represent the complete specification for the file: 

dev:<directoi:y>name.typ.gen;attributes 

One or more fields of the specification can be defined by a logical 
name. (Refer to Section 2.2.2.) If any fields are omitted from the 
specification, the system will provide the values shown below. 

device connected structure 

directory connected directory 

NOTE 

If neither device nor directory is 
specified, the default is DSK:, not the 
user's connected directory. If either 
device or directory is specified, the other 
is the user's connected structure/directory. 

name no default; this field must be specified 

type null 

generation highest existing number if the file is an input 

file. Next higher number if the file is an output 

file, 
protection protection of the next lower generation or for new 

files, protection as specified in the directory, 
account account specified when user logged in, unless 

changed by the CACCT or SACTF call. 

The JFNS monitor call can be used to obtain the file specification 
string associated with a given JFN. The flag bits that can be 
specified in AC1 are described as follows. 
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TOPS-20 MONITOR CALLS 
(GTJFN Short Form) 



GTJFN Flag Bits 



Bit Symbol 
GJ%FOU 



GJ%NEW 



GJ%OLD 



GJ%MSG 



GJ%CFM 



GJ%TMP 



GJ%NS 



GJ%ACC 



GJ%DEL 



Meaning 

The file given is to be assigned the 
next higher generation number. This 
bit indicates that a new version of a 
file is to be created, and is usually 
set if the file is for output use. 

The file specification given must not 
refer to an existing file (the file 
must be a new file) . This bit has no 
effect on a parse-only JFN. 

The file specification given must 
refer to an existing file. This bit 
has no effect on a parse-only JFN. 

One of the appropriate messages is to 
be printed after the file 
specification is obtained, if the 
system is performing recognition on 
the file specification and the user 
ends his input by typing an ESC. 

!NEW FILE! 

•NEW GENEPATION! 

!OLD GENERATION! 

!0K! if GJ%CFM (bit 4) is off 

"CONFIRM! if GJ%CFM (bit 4) is on 

Confirmation from the user will be 

required (if GJ%FNS is on) to verify 

that the file specification obtained 

is correct. (See below for the valid 
confirmation characters.) 



The file specified is 
temporary file. 



to 



be 



Only the first specification in a 
multiple logical name assignment is to 
be searched for the file ( do not 
search beyond the first name in a 
multiple logical name assignment). 

The JFN specified is not to be 
accessed by inferior processes in this 
job. However, another process can 
access the file by acquiring a 
different JFN. To prevent the file 
from being accessed by other 
processes, the user's program should 
set OF%RTD(B29) in the OPENF call. 

Files marked as deleted are to be 
considered by the system when it is 
searching for a file to assign to the 
JFN. 
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Bit 


Symbol 


9-10 


GJ%JFN 


11 


GJ%IFG 



TOPS-20 MONITOR CALLS 
(GTJFN Short Form) 



Meaning 

These bits are off in the short form 
of the GTJFN call. 

The file specification given is 
allowed to have one or more of its 
fields specified with a wildcard 
character (* or %). This bit is used 
to process a group of files and is 
generally used for input files. The 
monitor verifies that at least one 
value exists for each field that 
contains a wildcard and assigns the 
JFN to the first file in the group. 
The monitor also verifies that fields 
not containing wildcards represent a 
new or old file according to the 
setting of GJ%NEW and GJ%OLD. The 
GNJFN call can then be used to obtain 
the next file in the group. (Refer to 
Section 2.2.3 for more information on 
wildcard characters in file 
specifications. ) 

12 GJ%OFG The JFN is to be associated with the 

given file specification string only 
and not to the actual file. The 
string may contain wildcard characters 
(* or %) in one or more of its fields. 
It is checked for correct punctuation 
between fields, but is not checked for 
the validity of any field. This bit 
allows a JFN to be associated with a 
file specification even if the file 
specification does not refer to an 
actual file. The JFN returned cannot 
be used to refer to an actual file 
(e.g., cannot be used in an OPENF 
call) but can be used to obtain the 
original input string (via JFNS). The 
fields in this string can then be used 
in a GTJFN-long form call as program 
defaults. However, if the original 
string contains the temporary file 
attribute (;T), this attribute is not 
"remembered" and thus is not returned 
on the JFNS call even though the bit 
indicating temporary status (JS%TMP) 
is set. All other fields (including 
the protection and account fields) can 
be returned by JFNS. 
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(GTJFN Short Form) 



Bit Symbol 



12 



GJ%OFG 
(Cont. ) 



When both Bl 
are on, the 
specif icatio 
existence o 
wildcard cha 
the GTJFN ca 
fields for 
returns a 
specif icatio 
once a wildc 
action take 
taken when o 
If no wild 
the string, 
if both bits 



Meaning 

1(GJ%IFG) and B12(GJ%0FG) 
GTJFN call parses the 
n given, verifying the 
f each field. When a 
racter appears in a field, 
11 checks the remaining 

correct punctuation and 
JFN for the file 
n string only. That is, 
ard character is seen, the 
n is identical to that 
nly B12(GJ%0FG) is set. 
card character appears in 
the action i_ the same as 

were off. 



13 



GJ%FLG 



Flags are to be returned in the left 
half of AC1 on a successful return. 



14 



GJ%PHY 



Job-wide logical names (those defined 
by the user) are to be ignored by the 
monitor for this call. 



15 



GJ%XTN 



This bit is off in the short form 
the GTJFN call. 



of 



16 



GJ%FNS 



The contents of AC2 
interpreted as follows 



are 



to 



be 



1 



If this 


; bit 


is 


on, 


AC 2 


contains an 


input 


JFN 


in 


the 


left 


half 


and an 


output 


JFN 


in 


the 


right half 


The 


input 


JFN 


is 


used to obtain the 


file 


specif icat 


ion 


to 


be 


associated 


with 


the 


JFN. 


The 


output 


JFN 


is 


used 


to 


indica 


te the 


destination 


for printi: 


ng the 


names 


of any 


fie 


Ids 


being 


recog 


nized . 


To omit either 


JFN 


, sp 


ecif y 


.NULIO 


(377777) . 













If this bit is off, AC2 contains a 
byte pointer to an ASCIZ string in 
memory that specifies the file to 
be associated with the JFN. 



17 



GJ%SHT 



This bit must be on for the short form 
of the GTJFN call. 
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Bit Symbol 
18-35 



TOES-20 MONITOR CALLS 
(GTJFN Short Form) 



Meaning 

The generation number of the file 
(between 1 and 377777) or one of the 
following : 



(.GJDEF) 



to ind 

higher 

of the 

if GJ 

or to 

highes 

genera 

file 

GJ%FOU 

value 

this f 



icate 
gen 

file 
%FOU 
indie 
t 

tion 
is t 
is 

is u 
ield. 



tha 
erat 

is 

(bit 
ate 

numb 
o b 
off 
sual 
) 



t the next 

ion number 

to be used 

0) is on, 

that the 

existing 

er of the 

e used if 

(This 

ly used in 



-1 (.GJNHG) 



to indicate that the next 
higher generation number 
of the file is to be used 
if no generation number 
is supplied. 

to indicate that the 
lowest existing 

generation number of the 
file is to be used. 

to indicate that all 
generation numbers (*) of 
the file are to be used 
and that the JFN is to be 
assigned to the first 
file in the group. (Bit 
GJ%IFG must be set.) 

The GTJFN monitor call always reads the terminating character after 
the file specification string. (This character can be obtained by 
executing the BKJFN call followed by a BIN call.) The valid 
terminating characters are: 



2(.GJLEG) 



-3(.GJALL) 



line feed 

CTRL/L 

CTRL/Z 

carriage return 

exclamation point 

double quotation marks 

number sign 

ampersand 

single quotation mark 



left parenthesis 

right parenthesis 

plus sign 

comma 

slash 

equals sign 

at sign (@) 

space 

ESC 



All of these characters except for ESC are also confirmation 
characters (refer to bit GJ%CFM above) and are called confirming 
terminators. If a confirming terminator is typed after the string, a 
confirmation message will not be typed to the user nor will the user 
be required to confirm the string obtained, regardless of the setting 
of GJ%MSG and GJ%CFM. On a successful return, the following flags are 
returned in the left half of AC1 if flag bit GJ%IFG, GJ%OFG, or GJ%FLG 
was on in the call. 
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TOPS-20 MONITOR CALLS 
(GTJFN Short Form) 

Bits Returned on Successful GTJFN Call 



Bit 




10 



11 



12 



17 



Symbol 
GJ%DEV 

GJ%UNT 



GJ%DIR 



GJ%NAM 



GJ%EXT 



GJ%VER 



GJ%UHV 



GJ%NHV 



GJ%ULV 



GJ%PRO 



GJ%ACT 



GJITFS 



GJ%GND 



GJ%INV 



Meaning 

The device field of the file 

specification contained wildcard 
characters . 

The unit field of the file 

specification contained wildcard 

characters. This bit will never be 
set because wildcard characters are 
not allowed in unit fields. 

The directory field of the file 

specification contained wildcard 
characters . 

The filename field of the file 

specification contained wildcard 
characters. 



The file type 
specification 
characters . 



field of 
contained 



the file 
wildcard 



The generation number field of the 
file specification contained wildcard 
characters. 

The file used has the highest 
generation number because a generation 
number of was given in the call. 

The file used has the next higher 
generation number because a generation 
number of or -1 was given in the 
call. 

The file used has the lowest 
generation number because a generation 
number of -2 was given in the call. 

The protection field of the file 
specification was given. 

The account field of the file 
specification was given. 

The file specification is for a 
temporary file. 

Files marked for deletion were not 
considered when assigning JFNs. This 
bit is set if GJ%DEL was not set in 
the call. 

Invisible files were not considered 
when assigning JFNs. This bit is 
always on for the short form GTJFN. 
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(GTJFN Short Form) 



GTJFN ERROR MNEMONICS: 

GJFX1: Desired JFN invalid 

GJFX2: Desired JFN not available 

GJFX3: No JFNs available 

GJFX4: Invalid character in filename 

GJFX5: Field cannot be longer than 39 characters 

GJFX6: Device field not in a valid position 

GJFX7: Directory field not in a valid position 

GJFX8: Directory terminating delimiter is not preceded by a valid 
beginning delimiter 

GJFX9: More than one name field is not allowed 

GJFX10: Generation number is not numeric 

GJFX11: More than one generation number field is not allowed 

GJFX12: More than one account field is not allowed 

GJFX13: More than one protection field is not allowed 

GJFX14: Invalid protection 

GJFX15: Invalid confirmation character 

GJFX16: No such device 

GJFX17: No sucb directory name 

GJFX18: No such filename 

GJFX19: No such file type 

GJFX20: No such generation number 

GJFX21: File was expunged 

GJFX22: Insufficient system resources (Job Storage Block full) 

GJFX23: Exceeded maximum number of files per directory 

GJFX24: File not found 

GJFX27: File already exists (new file required) 

GJFX28: Device is not on-line 

GJFX30: Account is not numeric 

GJFX31: Invalid wildcard designator 

GJFX32: No files match this specification 

GJFX33: Filename was not specified 
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TOPS-20 MONITOR CALLS 
(GTJFN Short Form) 



GJFX34: Invalid character "?" in file specification 

GJFX35: Directory access privileges required 

GJFX36: Internal format of directory is incorrect 

GJFX37: Input deleted 

GJFX38: File not found because output-only device was specified 

GJFX39: Logical name loop detected 

GJFX40: Undefined attribute in file specification 

GJFX41: File name must not exceed 6 characters 

GJFX42: File type must not exceed 3 characters 

GJFX43: More than one ;T specification is not allowed 

GJFX44: Account string does not match 

GJFX45: Illegal to request multiple specifications for the same 
attr ibute 

GJFX46: Attribute value is required 

GJFX47: Attribute does not take a value 

GJFX48: GTJFN input buffer is empty 

GJFX49: Invalid attribute for this device 

GJFX51: Byte count too small 

10X11: Quota exceeded 

10X34: Disk full 

10X35: Unable to allocate disk - structure damaged 

DESX9: Invalid operation for this device 

STFX09: Prior structure mount required 
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TOPS-20 MONITOR CALLS 
(GTJFN Long Form) 

GTJFN JSYS 20 

Returns a JFN for the specified file. Accepts the specification for 
the file from both a string in memory and from a file. If both are 
given as arguments, the string is used first, and then the file is 
used if more fields are needed to complete the specification. This 
form also allows the program to specify nonstandard values to be used 
for omitted fields and to request the assignment of a specific JFN. 

ACCEPTS IN AC1: in the left half, and address of the beginning of 
the argument table in the caller's address space in 
the right half 

AC2: byte pointer to ASCIZ file specification string in 
the caller's address space, or if none 

RETURNS +1: failure, error code in AC1 

+2: success, flags in the left half of AC1, and the JFN 
assigned in the right half of AC1. (This word is 
called an indexable file handle and is given to the 
GNJFN call as an argument.) Updated string pointer in 
AC2, if pertinent. 

All I/O errors can occur. These errors cause software interrupts or 
process terminations, and only a single return (+1) is given. 

The format of the argument table specified by the right half of AC1 is 
described below. Words through 10 ( .GJGEN-.GJJFN) must be supplied 
in the long form of the GTJFN call. The remaining words are optional, 
and if they are supplied, B15(GJ%XTN) of word .GJGEN must be on. 

Meaning 

Flag bits in the left half and generation number 
in the right half. (See below.) 

Input JFN in the left half and output JFN in the 
right half. To omit either JFN, specify .NULIO 
(377777) . 

.GJDEV Byte pointer to ASCIZ string that specifies the 

default device to be used when none is given. If 

this word is 0, the user's connected structure 
will be used. 

.GJDIR Byte pointer to ASCIZ string that. specifies the 
default directory to be used when none is given. 
The string should not include brackets around the 
name . 

If this word is 0, the user's connected directory 
will be used. 

.GJNAM Byte pointer to ASCIZ string that specifies the 
default filename to be used when none is given. 
If this word is 0, either the string or the input 
JFN must supply the filename. 



Word 


Symbol 





.GJGEN 


1 


.GJSRC 
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(GTJFN Long Form) 



Word Symbol Meaning 

5 .GJEXT Byte pointer to ASCIZ string that specifies the 

default file type to be used when none is given. 
If this word is 0, the null file type will be 
used . 

6 .GJPRO Byte pointer to ASCIZ string that specifies the 

default protection to be used when none is given. 
If this word is 0, the default protection as 
specified in the directory or the protection of 
the next lower generation will be used. 

7 .GJACT Byte pointer to ASCIZ string that specifies the 

default account to be used when none is given. If 
this word is 0, the user's LOGIN account (unless 
changed) will be used. 

10 .GJJFN The JFN to associate with the file specification 

if flag GJ%JFN is set in word (.GJGEN) of the 
argument block. 

11 .GJF2 Extended argument block if B15(GJ%XTN) is on in 

the left half of .GJGEN. This word contains a 
second group of flags in the left half and the 
count of the number of words following this word 
in the argument block in the right half. The 
flags in the left half specify additional control 
over the GTJFN process. The following flags are 
defined : 

B0(G1%RND) Return to the caller if the filename 
buffer becomes empty, and the user 
attempts to delete a character. This 
can occur if the user, when giving the 
filename, types a CTRL/U or types a 
DELETE or CTRL/W and there are no more 
characters in the buffer. 

B2(G1%NLN) Filenames cannot be longer than 6 
characters and file types cannot be 
longer than 3 characters. In addition, 
the generation number, temporary 
status, protection, and account fields 
cannot be specified in the string or 
the input data. 

B3 (G1%RCM) Return the confirmation message to the 
caller by placing it in the destination 
buffer . 

B4(G1%RIE) Return to the caller if the input 
buffer becomes empty, and the user 
attempts to delete a character. 

B5(G1%IIN) Files marked as invisible are to be 

considered by the system when it is 

searching for a file to assign to the 
JFN. 
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Word Symbol Meaning 

11 .GJF2 B6(G1%SLN) Prohibit the expansion of logical 
(Cont.) names. If, for example, user DBELL 

defines logical name ME: to be 
PS:<DBELL> and does a GTJFN for file 
ME:FOO.BAR, the file specification 
stored in the JFN block will be: 

PS : <DBELL>FOO.BAR 

In this case, the logical name ME: has 
been expanded to PS:<DBELL>. However, 
if bit G1%SLN is set, and a GTJFN 
performed on file FOO.BAR, the file 
specification stored in the JFN block 
is: 



12 



GJCPP 



13 



14 



GJCPC 



GJRTY 



15 



16 



GJBFP 



GJATR 



ME -.FOO.BAR 

In this case, the logical name has not 
been expanded. 

Byte pointer to string where GTJFN is to store the 
exact copy of the user's typescript (destination 
string pointer). This string will contain logical 
names, if they were typed by the user, and will 
not contain the default fields unless they were 
generated through recognition. This string allows 
the caller to obtain a true copy of the user's 
typescript. 

Number of bytes available in the destination 

string to which .GTCPP (word 12) points. If a 

pointer has been specified but this word is 0, the 

monitor assumes the string contains 130 bytes. 

Byte pointer to the text to be output when the 
user types a CTRL/R (i.e., pointer to the CTRL/R 
buffer). This pointer cannot be equal to the 
pointer given in AC2. (Refer to the TEXTI call 
for the definition of CTRL/R text.) 

Byte pointer to the beginning of the destination 
buffer. (obsolete) 

Pointer to the file specification attribute block. 

The attribute block has the following format: 

Word Contents 



Count of words in attribute 

(including this word). 

1 Byte pointer to argument string. 
1+n Byte pointer to argument string. 

The ASCIZ argument strings are specified as: 

keyword :attribute 



block 
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Word 
16 



Symbol 

.GJATR 
(Cont. ) 



TOPS-20 MONITOR CALLS 
(GTJFN Long Form) 



Meaning 



The possible keywords and attribute values are as 
follows: 



Keyword 

A: 

BDATA: 

BLOCK-LENGTH: 

BPASSWORD: 

CHARGE: 

DATA: 

EXPIRATION-DATE 

FORMAT: 



OFF-LINE 



PASSWORD: 
POSITION: 

RECORD-LENGTH 
T 



USERID 



Attribute Value 

Installation-defined account 
str ing 

DECnet binary optional data 
Magnetic-tape block length 
DECnet binary password 
DECnet account string 
DECnet optional data 
Magnetic-tape expiration date 
Magnetic-tape record format. 
The argument may be one of the 
following : 

Argument Meaning 



Fixed-length records 

Variable-length 

records 

Spanned 

Binary files with 

36-bits per word 



NONE - display- 
The attribute is 
bit FB%OFF in wo 
the FDB block. 
Octal file protec 
DECnet password s 
File sequence 
position magnetic 
Magnetic-tape rec 
NONE - display- 
The attribute is 
bit GJ%TMP in wo 
the GTJFN block. 
DECnet user ID st 



only keyword, 
set by setting 
rd .FBCTL of 

tion value 
tr ing 

number to 
-tape to. 
ord length 
only keyword, 
set by setting 
rd .GJGEN of 

r ing 



The flag bits accepted in the left half of .GJGEN (word 0) of the 
argument block are basically the same as those accepted in the short 
form of the GTJFN call. The entire set of bits is listed below. 
(Refer to GTJFN - SHORT FORM for more detailed explanations of these 
bits.) The flags that are different in the two forms are GJ%JFN, 
GJ%XTN, GJ%FNS, and GJ%SHT. 



Bit 


Symbol 





GJ%FOU 


1 


GJ%NEW 


2 


GJ%OLD 


3 


GJ%MSG 


4 


GJ%CFM 



Meaning 

Create a new version of the file. 

The file must not exist. 

The file must exist. 

Type a message if the user presses ESC 
terminate input . 

Confirmation from the user is required. 



to 
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Bit 


Symbol 


5 


GJ%TMP 


6 


GJ%NS 


7 


GJ%ACC 


8 


GJ%DEL 


-10 


GJ%JFN 



TOPS-20 MONITOR CALLS 
(GTJFN Long Form) 

Meaning 

The file is temporary. 

Search only the first specification in a multiple 
logical name definition. 

The JFN cannot be accessed by inferior processes. 

Ignore the file deleted bit in the FDB . 

Associate the JFN supplied in .GJJFN (word 10) of 
the argument block with the file specification. 
The value of this field is interpreted as follows: 

Value Meaning 

O(.GJDNU) Ignore the JFN supplied. 

2(.GJERR) Attempt to assign the JFN supplied and 

return an error if it is not 

available . 

3(.GJALT) Attempt to assign the JFN supplied 

and, if it is not available, assign an 

alternate. 

11 GJ%IFG The file specification can contain wildcard 
characters. 

12 GJ%OFG Associate the JFN with the file specification 
string and not the file itself. This is termed a 
"parse-only JFN", and allows the syntax of a file 
name to be checked regardless of whether or not a 
file of that name actually exists. 

Return flags in AC1 on successful completion of 
the call. 

The physical device is to be used. 

The argument block contains more than 10 (octal) 
words. 

This bit is ignored for the long form of the GTJFN 
call. 

This bit must be off for the long form of the 
GTJFN call. 

The generation number given in the right half of .GJGEN (word 0) of 
the argument block can be one of the following: 

O(.GJDEF) to indicate that the next higher generation number is to 
be used if GJ%FOU is on, or to indicate that the highest 
existing generation number is to be used if GJ%FOU is 
off. 

-l(.GJNHG) to indicate that the next higher generation number is to 
be used if no generation number is supplied. 



13 


GJ%FLG 


14 


GJ%PHY 


15 


GJ%XTN 


16 


GJ%FNS 


17 


GJ%SHT 
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(GTJFN Long Form) 



-2(.GJLEG) to indicate that the lowest existing generation number 
is to be used if no generation number is supplied. 

-3(.GJALL) to indicate that all generation numbers are to be used 
and that the JFN is to be assigned to the first file in 
the group, if no generation number is supplied. (Bit 
GJ%IFG must be on. ) 

1-377777 to indicate that the specified number is to be used as 
the generation if no generation number is supplied. 

On a successful return, the following flags are returned in the left 
half of AC1 if flag bit GJ%IFG, GJ%OFG, or GJ%FLG was on in the call. 



Bits Returned on Successful GTJFN Call 



Bit 




Symbol 
GJ%DEV 



Meaning 

The device field of the file 
specification contained wildcard 
characters . 



GJ%UNT 



The unit field of the file 
specification contained wildcard 
characters. This bit will never be 
set because wildcard characters are 
not allowed in unit fields. 



GJ%DIR 



The directory field of the file 
specification contained wildcard 
characters. 



GJ%NAM 



The filename field of the file 
specification contained wildcard 
characters . 



GJ%EXT 



The file type 
specification 
characters . 



field of 
conta ined 



the file 
wildcard 



GJ%VER 



The generation number field of the 
file specification contained wildcard 
characters . 



GJ%UHV 



GJ%NHV 



The file used has the highest 
generation number because a generation 
number of was given in the call. 

The file used has the next higher 
generation number because a generation 
number of or -1 was given in the 
call. 



10 



GJ%ULV 



GJ%ACT 



The file used has the lowest 
generation number because a generation 
number of -2 was given in the call. 



The account field of 
specification was given. 



the 



file 
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TOPS-20 MONITOR CALLS 
(GTJFN Long Form) 

Bit Symbol Meaning 

11 GJ%TFS The file specification is for a 

temporary file. 

12 GJ%GND Files marked for deletion were not 

considered when assigning JFNs. This 
bit is set if GJ%DEL was not set in 
the call. 

17 GJ%GIV Invisible files were not considerd 

when assigning JFNs. This bit is set 
by the monitor if G1%IIN was not set 
by the user in the GTJFN call. 

Refer to the short form of the GTJFN call for the possible error 
mnemonics . 
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TOPS-20 MONITOR CALLS 
(GTRPI) 

GTRPI JSYS 172 

Returns the paging trap information for the specified process. 
ACCEPTS IN AC1: process handle 

RETURNS +1: always, with 

AC1 containing number of pager traps (i.e., the number of 
times a trap has occurred to the pager) for 
designated process since the process was started 

AC2 containing number of page faults (i.e., the number of 
times a trap has resulted in a page being swapped in) 
for designated process since the process was started 

AC3 containing time spent (in milliseconds) in page 
routines by designated process since the process was 
started 

The number of pager traps will be greater than or equal to the number 
of page faults. 

Generates an illegal instruction interrupt on error conditions below. 

GTRPI ERROR MNEMONICS: 

FRKHXl: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(GTNCP%) 

GTNCP% JSYS 272 

Obtains information about the NCP. 

RESTRICTIONS: for ARPANET systems only 

function code 

function-specific argument 

function-specific argument 

function-specific argument 

failure, error code in AC1 

success, function-specific data returned in AC * s 

Function 

Returns negative number of NCP connections 

User-supplied arguments: 

None 

Returned data: 

AC2: -number NCP connect ions ,, 

AC3: -number NVTs ,, line number of first NVT 



ACCEPTS 


IN AC1: 




AC 2: 




AC 3: 




AC4: 


RETURNS 


+ 1: 




+ 2: 


Code 


Symbol 





.GTNSZ 



.GTNIX 



Returns status of connection number 
User-supplied arguments: 



AC 2 
AC3 
AC4 



connection number 

30 bit address of storage block 

-length of block , , index of first data item 

to return 



.GTNNI 



Returned data: 
(See format of block below) 

Return status of NVT line number (input connection) 
User-supplied arguments: 



AC 2 
AC3 
AC4 



NVT line number (input) 

30 bit address of storage block 

-length of block ,, index of first data item 

to return 



Returned data: 
(See format of block below) 
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(GTNCP%) 



Code Symbol 
3 . GTNNO 



Return status of NVT connection (output connection) 
User supplied arguments: 



AC2 
AC3 
AC4 



NVT line number (output) 

30 bit address of storage block 

-length of block , , index of first data item 

to return 



.GTNJF 



Returned data: 

(See format of block below) 

Return status of network-connection JFN 

User-supplied arguments: 



AC2 
AC3 
AC4 



JFN 

30 bit address of storage block 

-length of block , , index of first data item 

to return 



Returned data: 
(See format of block below) 
Format of returned data block: 

Contents 



Word 



Symbol 






.NCIDX 


1 


.NCFHS 


2 


.NCLSK 


3 


.NCFSK 


4 


.NCFSM 


5 


.NCLNK 


6 


.NCNVT 


7 


.NCSIZ 


10 


.NCMSG 


11 


•NCBAL 


12 


.NCDAL 


13 


.NCBTC 


14 


.NCBPB 


15 


•NCCLK 


16 


.NCSTS 



NCP connection index 

Foreign host 

Local socket 

Foreign socket 

State of connection 

Link 

NVT, or -1 if none 

Byte size of connection 

MSG allocation 

Bit allocation 

Desired allocation 

Bits transferred 

Bytes per buffer 

Time-out countdown 

Connection status 



GTNCP% ERROR MNEMONICS 



ARGX02 
GTJIX1 
GTNCXl 
GTNCX2 



Invalid function 

Invalid index 

Invalid network JFN 

Invalid or inactive NVT 
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TOPS-20 MONITOR CALLS 
(GTRPW) 

GTRPW JSYS 171 

Returns the trap words. This monitor call allows a program to 
retrieve information about a previous read, write, or execute trap. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with trap status word from last memory trap 
in AC1, and last, monitor call that had an error in 
AC2. 

The following bits are defined in the status word: 

BO (PF%USR) page failure-user mode reference 

B5(PF%WRT) page failure-write reference 

B14(TSW%RD) trap status-read (always on) 

B15(TSW%WT) trap status-write (same setting as B5) 

B16(TSW%EX) trap status-execute (always on) 

B17(TSW%MN) trap status-monitor mode reference (complement of BO) 

B18-B35 address of reference that caused the trap 

This information allows a program to determine the exact cause of a 
memory trap and/or the effective virtual address that caused the trap. 
This information is sufficient to enable the program to continue, if 
desired, when the cause of the trap has been removed. 

The contents of AC1 is if there have been no memory traps. 

Generates an illegal instruction interrupt on error conditions below. 

GTRPW ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(GTSTS) 

GTSTS JSYS 24 

Returns the status of a file associated with a JFN, 

ACCEPTS IN AC1: JFN in the right half 

RETURNS +1: always, with status in AC2. If JFN is illegal in any 
way, BIO of AC2 will be 0. 

JFN STATUS WORD 



BO (GS%OPN) 
Bl (GS%RDF) 

B2 (GS%WRF) 
B3(GS%XCF) 
B4 (GS%RND) 
B7 (GS%LNG) 
B8 (GS%EOF) 
B9 (GS%ERR) 

BIO (GS%NAM) 
Bll (GS%AST) 
B12(GS%ASG) 
B13(GS%HLT) 
B17 (GS%FRK) 



B18 (GS%PLN) 



B32-B35 
(GS%MOD) 



file is open 

if file is open (if bit is on), it is open for read 

access 

if file 

if file 

if file 



is open, it is 
is open, it is 
is open, it is 
file is longer than 51 
last read was past end 
file may be in error ( 
occurred) 

file specification is 
the JFN is parse-only 
JFN is currently being 
I/O errors are conside 
This is a restricted 
call). Only the proce 
it. Other processes m 
if set, line numbers, 
passed to the program 
zero, line numbers are 
the program, 
data mode of the file. 



open for write access 
open for execute access 
open for non-append access 

2 pages 
of file 

i.e., a device or data 



error 



associated with this JFN 
(GJ%OFG was set in GTJFN call) 

assigned 
red terminating conditions 
JFN (GJ%ACC was set in GJTFN 
ss that received this JFN may use 
ay get another JFN for this file. 

if present in the file, are 
during input (SIN, BIN, etc) . If 

stripped from the data passed to 

Refer to Chapter 2. 



.GSNRM normal data mode 
.GSIMG image mode 

.GSSMB small buffer mode 
.GSDMP dump mode 

If B0(GS%OPN) is not set on return, the file is not opened, and the 
settings of bits 1 through 4 are indeterminate. 

The STSTS call can be used to set the status of a particular file. 
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TOPS-20 MONITOR CALLS 
(GTTYP) 

GTTYP JSYS 303 

Returns the terminal type number for the specified terminal line. 
(Refer to Section 2.4.9.4 for the terminal type numbers.) 

ACCEPTS IN AC1: file designator (only terminal designators are legal) 

RETURNS +1 : always, with terminal type number in AC2 and buffer 
allocation numbers (# of input buffers to be 
allocated in left half, and # of output buffers to be 
allocated in right half) in AC3. AC1 is unchanged. 

The STTYP monitor call can be used to set the terminal type number for 
a specified line. 

Generates an illegal instruction interrupt on error conditions below. 

GTTYP ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

TTYX01: Line is not active 
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TOPS-20 MONITOR CALLS 
(HALTF) 

HALTF JSYS 170 



Halts the current process and any inferior processes of the current 
process. Sets the process' PC to the next instruction after the call 
and saves it in the Process Storage Block (PSB) in case the process is 
continued. The user can continue the process by typing the CONTINUE 
command, which causes the process to start at the next instruction. 

Sets bits 1-17(RF%STS) in the status word for this process to 
2(.RFVPT). Refer to the RFSTS monitor call for the format of the 
status word. 

If the top level process executes a HALTF call and does not have WHEEL 
or OPERATOR capability enabled, the job is logged out. If the top 
level process executes a HALTF call and does have WHEEL or OPERATOR 
capability enabled, control passes to mini-exec level. 



3-200 



TOPS-20 MONITOR CALLS 
(HFORK) 

HFORK JSYS 162 



Halts one or more inferior processes. (Refer to the HALTF monitor 
call description to halt the current process.) 

ACCEPTS IN AC1: process handle (inferior processes only) 

RETURNS +1: always 

Sets bits 1-17(RF%STS) in the status word(s) for addressed process(s) 
to 2(.RFVPT). Refer to the RFSTS monitor call for the format of the 
status word. 

Generates an illegal instruction interrupt on error conditions below. 

HFORK ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
HFRHX1 



Invalid process handle 

Illegal to manipulate a superior process 

Illegal to halt self with HFORK 



3-201 



TQPS-20 MONITOR CALLS 
(HPTIM) 



HPTIM 



JSYS 501 



Returns the value of one of the high precision system clocks. 
Although the main time base from interrupts generated by the internal 
system clock is in units of 1 millisecond, the clock provides a time 
base in units of 10 microseconds. The HPTIM monitor call provides 
access to the variables kept in these high precision units. 



ACCEPTS IN AC1 

RETURNS +1 

+ 2 



number of the clock to read (see below) 

failure, error code in AC1 

success, with AC1 containing the value of the 
specified clock 



The numbers for currently-defined clocks are: 

.HPELP Elapsed time since system startup. (Refer to the 

TIME call for obtaining the time in milliseconds.) 

1 .HPRNT CPU runtime for this process. (Refer to the RUNTM 

call for obtaining the time in milliseconds.) 

HPTIM ERROR MNEMONICS: 

HPTX1: Undefined clock number 
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TOPS-20 MONITOR CALLS 
(HSYS) 

HSYS JSYS 307 



Initiates an orderly shutdown of the timesharing operation of the 
system. This call causes periodic notices of the impending shutdown 
to be issued to all terminals. It also causes any jobs still logged 
in at the designated shutdown to be logged out. 



RESTRICTIONS: 
ACCEPTS IN AC1 
AC2 

+ 1 
+ 2 



RETURNS 



requires WHEEL, OPERATOR, or MAINTENANCE capabilities 
enabled 

shutdown time with the date and time in the internal 
format. (Refer to Section 2.9.2.) 

date and time in internal format when system 
operation will resume (or if unknown) . Used for 
advisory messages only. 

failure, error code in AC1 

success, shutdown procedure initiated 



The shutdown notice is issued immediately to all terminals if the 
shutdown time is within two hours. The notice is also sent two hours, 
one hour, 30 minutes, 10 minutes, 5 minutes, and one minute before the 
shutdown. 

The time when the system is expected to be placed back into operation 
is not used directly by the monitor. It is entered into a GETAB table 
where it may be examined with the GETAB monitor call. 

HSYS ERROR MNEMONICS: 

CAPX2: WHEEL, OPERATOR, or MAINTENANCE capability required 

TIMEX1: Time cannot be greater than 24 hours 

TIMEX2: Downtime cannot be more than 7 days in the future 
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TOPS-20 MONITOR CALLS 
(IDCNV) 

IDCNV JSYS 223 



Converts separate numbers for the local year, month, day, and time 
into the internal date and time format. (Refer to Section 2.9.2 for 
more information on the internal format.) 



ACCEPTS IN AC2: year in the left half, and 
(0=January) in the right half 



numerical month 



AC3: day of the month (0=first day) in the left half, and 
in the right half 

AC4: B0(IC%DSA) apply daylight savings according to the 

setting of B1(IC%ADS). If BO is off, 

daylight savings is applied only if 
appropriate for the date. 

B1(IC%ADS) apply daylight savings if B0(IC%DSA) is 
on. 

B2(IC%UTZ) use time zone in B12-B17. If this bit is 
off, the local time zone is used. 

B3(IC%JUD) interpret the number in the right half of 
AC2 as being in Julian day format (Jan 1 
is day 1 ) . 



B12-B17 
(ICITMZ) 



B18-B35 
(IC%TIM) 



time zone to use if B2(IC%UTZ) is on. 
(Refer to Section 2.9.2 for the time 
zones. ) 

local time in seconds since midnight. 



RETURNS 



+1: failure, error code in AC1 

+2: success, AC2 contains the internal date and time, and 
AC3 contains 

BO and B2 on for compatibility with the ODCNV call 

B1(IC%ADS) on if daylight savings was applied 

B12-B17 time zone used 
(IC%TMZ) 



IDCNV ERROR MNEMONICS 



DATEX1 
DATEX2 
DATEX3 
DATE X 5 
DATEX7 
TIMEX1 
ZONEX1 



Year out of range 

Month is not less than 12 

Day of month too large 

Date out of range 

Julian day is out of range 

Time cannot be greater than 24 hours 

Time zone out of range 
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TOPS-20 MONITOR CALLS 
(IDTIM) 



IDTIM 



JSYS 221 



Inputs the date and time and converts them to the internal date and 
time format. (Refer to Section 2.9.2.) The IDTIM monitor call does 
not permit either the date or the time to be entered separately and 
does not perform conversions for time zones other than the local one 
(unless the time zone is specified in the input string). Refer to the 
IDTNC and IDCNV monitor calls descriptions for these functions. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



source designator 

format option flags (see below), is the normal case 

failure, error code in AC2, updated string pointer in 
AC1, if pertinent 

success, updated string pointer, if pertinent, in 
AC1, and the internal format date and time in AC2 



The format option flags in AC2 specify the interpretation to be used 
when a date or time specification is ambiguous. 

IDTIM Option Flags 

Bl (IT%NNM) Do not allow the month to be numeric and ignore B2-B3. 

B2(IT%SNM) Interpret the second number in the date as the month 
(e.g., 6/2/76 is interpreted as Feb. 6, 1976). If 
this bit is off, the first number is interpreted as the 
month (e.g., 2/6/76 is interpreted as Feb. 6, 1976). 

B3(IT%EER) Return an error if the order of the day and month does 
not agree with the setting of B2(IT%SNM) even though 
the date can be successfully interpreted. If this bit 
is off, a date which can be interpreted by assuming the 
day and month are in the opposite order than that 
specified by the setting of B2(IT%SNM) will be 
considered valid. For example, if B2-B3 are off, 
30/5/76 will be considered as a valid date. 

B7(IT%NIS) Seconds cannot be included in a time specification. 

B8(IT%AIS) Seconds must be included in a time specification and 
must be preceded by a colon. 

If B7-B8 are both off, seconds are optional in a time 
specification. If specified, seconds must be preceded 
by a colon. 

B9 (IT%NAC) Colon cannot be used to separate hours and minutes. 

B10(IT%AAC) Colon must be used to separate hours and minutes. 

If B9-B10 are both off, a colon is optional between 
hours and minutes. 

B11(IT%AMS) When B7-B10 are off, always interpret a time 
specification containing one colon as hhmmrss. 
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TOPS-20 MONITOR CALLS 
(IDTIM) 



B12(IT%AHM) When B7-B10 are off, always interpret a time 
specification containing one colon as hh:mm and return 
an error if the first field is too large. This differs 
from B7(IT%NIS) in that seconds can be included if 
preceded by a second colon. 

If B7-B12 are all off, a time specification containing 
one colon is interpreted as hh:mm if the first field is 
small enough. Otherwise it is interpreted as hhmmrss. 

B14(IT%N24) Do not allow the time to be specified in 24-hour format 
(e.g., 1520 for 3:20 in the afternoon) and make AM or 
PM specification mandatory. 

B15(IT%NTM) Do not allow the time specification to include 
AM, PM, NOON, or MIDNIGHT. 

B16(IT%NTZ) Do not allow a time zone to be specified. 

If AC2 is 0, the IDTIM call accepts any reasonable date and time 
formats. In cases where pure numeric representation is used for the 
date (1/9/1967, for example), IDTIM checks the first number for being 
in the range: 0<n<13. If the test is successful, the first number is 
interpreted as the month. If the test is unsuccessful, the test is 
made on the second number and if successful, that number is 
interpreted as the month. Otherwise an error is generated. For 
example : 

1. 5/6/1976 is interpreted as May 6, 1976 

2. 6/5/1976 is interpreted as June 5, 1976 

3. 13/5/1976 is interpreted as May 13, 1976 

4. 13/13/1976 generates an error 



IDTIM ERROR MNEMONICS 



DILFX1 
TILFX1 
DATEX1 
DATEX3 
DATEX5 



Invalid date format 
Invalid time format 
Year out of range 
Day of month too large 
Date out of range 



All I/O errors are also possible. These errors cause software 
interrupts or process terminations as described under the BIN call. 
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TOPS-20 MONITOR CALLS 
(IDTNC) 

IDTNC JSYS 231 

Inputs the date and/or the time and converts it into separate numbers 
for the local year, month, day, or time. The IDTNC call allows the 
date or time to be entered separately, which is not possible with the 
IDTIM JSYS because neither one can be converted to the internal format 
without converting the other. (Refer to Section 2.9.2.) 

ACCEPTS IN AC1: source designator 

AC2: format option flags 

In addition to the flags described in the IDTIM call, 
the flags below can also be specified: 

B0(IT%NDA) Do not input the date and ignore B1-B3. 
If IT%NDA is off, the date must be input. 

B6(IT%NTI) Do not input the time and ignore B7-B16. 
If IT%NTI is off, the time must be input. 

RETURNS +1: failure, error code in AC2, updated string pointer, 
if pertinent, in AC1 

+2: success, updated string pointer, if pertinent, in AC1 

If the date was input, 

AC2 contains the year in the left half, and the month 

(0=January) in the right half. 
AC3 contains the day of the month (0=first day) in 

the left half, and the day of the week (0=Monday) 

in the right half. 

If the time was input, 
AC4 contains 

B0(IC%DAS) on if IT%NTI was set in AC2, or if 

IT%NDA was set in AC2 and a time zone 

was input (for compatibility with the 

ODCNV call) . 
B1(IC%ADS) on if a day 1 ight savings time zone 

was input, or if IT%NTI was set in 

AC2. 
B0(IC%UTZ) on if IT%NTI was set in AC2, or if 

IT%NDA was set in AC2 and a time zone 

was input (for compatibility with the 

ODCNV call) . 
B3(IC%JUD) on if a number in Julian day format 

was input. 
B12-B17 the time zone if one was input, or 
(IC%TMZ) the local time zone if none was 

input. (Refer to Section 2.9.2 for 

the time zones. ) 
B18-B35 time as seconds since midnight. 
(IC%TIM) 

A -1 returned in both AC2 and AC3 means the system date and time have 
not been set. 

IDTNC ERROR MNEMONICS: 

DILFX1: Invalid date format 

TILFX1: Invalid time format 
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All I/O errors are also possible. These errors cause software 
interrupts or process terminations as described under the BIN call 
description. 

The IDTNC call does not detect certain errors in date input, such as 
day 31 of a 30-day month. These errors are detected by the IDCNV 
call. 
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IIC JSYS 132 

Initiates software; interrupts on the specified channels in a process. 
(Refer to Section 2.6.) 

ACCEPTS IN AC1: process handle 

AC2: 36-bit word 

Bit n on means initiate a software interrupt on 
channel n. 

RETURNS +1: always 

Generates an illegal instruction interrupt on error conditions below. 

IIC ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

RRKHV "3 • Tnwal iH n g o n f mnl finlo ok/-ioq c^o han^l /-v ^^^^^^ 
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(IIC) 

IIC JSYS 132 



Initiates software interrupts on the specified channels in a process. 
(Refer to Section 2.6.) 

ACCEPTS IN AC1: process handle 

AC2: 36-bit word 

Bit n on means initiate a software interrupt on 
channel n. 

RETURNS +1: always 

Generates an illegal instruction interrupt on error conditions below. 

IIC ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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INLNM JSYS 503 

Returns a logical name that is defined either for this job or for the 
system. (Refer to Section 2.2.2 and CRLNM and LNMST monitor calls.) 

ACCEPTS IN AC1: function code in the left half, and index into the 
table of defined logical names in the right half 

AC2: byte pointer to the string for storing the logical 
name 

RETURNS +1: failure, error code in AC1 

+2: success, updated string pointer in AC2 
The available functions are: 

Code Symbol Meaning 

.INLJB List the logical names defined for this job 

1 .INLSY List the logical names defined for the system 
INLNM ERROR MNEMONICS: 

INLNX1: Index is beyond end of logical name table 
INLNX2: Invalid function 
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JFNS JSYS 30 

Returns the file specification currently associated with the JFN. 

ACCEPTS IN AC1: destination designator where the ASCIZ string is to 
be written 

AC2: indexable file handle (refer to GTJFN) , or pointer to 
string 

AC3: format control bits to be used when returning the 
string, or 

AC4: byte pointer to string containing prefix of file 
specification attribute 

RETURNS +1: always, with updated string pointer, if pertinent, in 
AC1 

AC2 can have one of two formats, depending on B26(JS%PTF) in AC3. The 
first format is a word with either or the flag bits returned from 
GTJFN in the left half and the JFN in the right half. When the left 
half is 0, the string returned is the exact specification associated 
with the JFN. If the given JFN is associated only with a file 
specification (i.e., it was obtained with B12(GJ%0FG) on in the GTJFN 
call), the string returned contains null fields for nonexistent fields 
or fields containing wildcards, and actual values for existent fields. 

When the left half is nonzero, the string returned contains wildcard 
characters for appropriate fields and 0, -1, or -2 as a generation 
number if the corresponding bit is on in the call. 

The second format (allowed only if B26 (JS%PTR) of AC3 is on) is a 
pointer to the string to be returned. This string is one field of a 
file specification. The field is determined by the first nonzero 
3-bit field in AC3 or by the setting of B27(JS%ATR) or B28(JS%AT1) in 
AC3. For example, if bits 6-8 (JS%NAM) of AC3 are nonzero, then the 
string is interpreted as a filename field. If B27(JS%ATR) is on, the 
string is interpreted as a file specification attribute. If 
B28(JS%AT1) is on, the string is concatenated to the string to which 
AC4 points, and a colon is inserted between the two strings. In all 
cases, the string is output to the destination designator, and the 
appropriate punctuation is added. 

AC3 contains control bits for formatting the string being returned. 
B0-B20 are divided into 3-bit bytes, each byte representing a field in 
the file specification. The value of the byte indicates the output 
for that field. The values are: 

(.JSNOF) do not output this field 

1 (.JSAOF) always output this field 

2 (.JSSSD) suppress this field if it is the system default 

The bits that can be set in AC3 are as follows: 

B0-B2 (JS%DEV) output for device field 

B3-B5 (JS%DIR) output for directory field 

B6-B8 (JS%NAM) output for filename field (2 is illegal) 

B9-B11 (JS%TYP) output for file type field (2 is illegal) 

B12-B14 (JS%GEN) output for generation number field 
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B0-B14 (JS%SPC) output for all file specification fields named 
above. This field should have the same bits set 
as would be set in the fields above. (See 
B35(JS%PAF) below.) 

B15-B17 (JS%PRO) output for protection field 

B18-B20 (JS%ACT) output for account field 

B21(JS%TMP) return ;T if appropriate 

B22(JS%SIZ) return size of file in pages 

B23(JS%CDR) return creation date 

B24(JS%LWR) return date of last write 

B25(JS%LRD) return date of last read 

B26 (JS%PTR) AC2 contains pointer to the string being returned 

B27(JS%ATR) return file specification attributes if 
appropriate 

B28(JS%AT1) return the specific specification attribute whose 
prefix is indicated by the string to which AC4 
points. This bit is used when a program is 
processing attributes one at a time. If JS%ATR 
is also set, all attributes will be returned 
(WHEEL capabilities are required to receive the 
password). See the description of the long-form 
GTJFN for a list of file attributes. 

B29(JS%OFL) return the "OFFLINE" attribute 

B32(JS%PSD) punctuate the size and date fields 

B33(JS%TBR) tab before all fields returned, except for first 
field 

B34(JS%TBP) tab before all fields that may be returned (i.e., 
fields whose value is given as 1 or 2), except 
for first field 

B35(JS%PAF) punctuate all fields from device through ;T 

If B32-B35 are 0, punctuation between fields is not used. 

If AC3 is 0, the string is output in the format 

dev: <d i r ec tor y> name . typ.gen;T 

The temporary attribute (;T) is not returned if the JFN is a 
parse-only JFN (refer to GJ%OFG in the GTJFN description) or the file 
is not temporary. 

The punctuation used on each field is shown below. 

dev:<directory>name.typ.gen;attribute 
, size , creation date, write date, read date 

The GTJFN or GNJFN monitor call is used to associate a JFN with a 
given file specification string. 

Generates an illegal instruction interrupt on error conditions below. 

JFNS ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 
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10X11 
10X34 
10X35 



Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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KFORK JSYS 153 



Kills one or more processes. When a process is killed, all private 
memory acquired by the process and its Process Storage Block are 
released. Also, any JFNs the process has created are released, and 
any terminal interrupt assignments that were acquired from another 
process are passed back. (Note that because the process is deleted 
asynchronously, a page of a file mapped into a lower process may not 
be unmapped before the KFORK call returns.) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, -with unless the current process attempts to 
kill itself 

The KFORK call will not release a process handle that identifies a 
process already killed by another process. In this case, the RFRKH 
call must be used to release the handle. 

The CFORK monitor call can be used to create an inferior process. 

Generates an illegal instruction interrupt on error conditions below. 

KFORK ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
KFRKX1 
KFRKX2 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to kill top level process 

Illegal to kill self 
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Kills the specified job and appends an accounting entry to the 
accounting data file. However, no entry is appended if the job was 
never logged in (i.e., a CTRL/C was typed, but no login occurred). 

some functions require WHEEL or OPERATOR capabilities 
enabled 



RESTRICTIONS: 
ACCEPTS IN AC1 



RETURNS 



+ 1 
+ 2 



number of the job to be logged out, or -1 for the 
current job 

failure, error code in AC1 

success 



When a specific job number is given in AC1, it must refer to either a 
PTY job controlled by the current job or a job logged in under the 
same user name as the current job. Otherwise, to give a specific job 
number, the process must have WHEEL or OPERATOR capability enabled. 
An argument of -1 must be given if the current job wishes to kill 
itself (i.e., the job number given cannot be the same as the current 
job). Note that this monitor call does not return if the argument in 
AC1 is -1. 

The LGOUT monitor call outputs the time used (both CPU and console) , 
the job number, and the current date and time. This information is 
output on the terminal to which the job being logged out is attached. 

LGOUT ERROR MNEMONICS: 

LOUTX1: Illegal to specify job number when logging out own job 

L0UTX2: Invalid job number 

L0UTX3: WHEEL or OPERATOR capability required 

L0UTX4: LOG capability required 

L0UTX5: Illegal to log out job 
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LNMST JSYS 504 

Translates a logical name to its original definition string. (Refer 
to Section 2.2.2 and the CRLNM and INLNM monitor calls descriptions.) 

ACCEPTS IN AC1: function code 

AC2: pointer to the logical name. The logical name must 
not contain a terminating colon. 

AC3: pointer to the string where the original logical name 
definition is to be written. The name returned 
includes a terminating colon. 

RETURNS +1: failure, error code in AC1 

+2: success, updated string pointer in AC3 

The codes for the functions are as follows: 

.LNSJB Obtain the job-wide definition of the logical name. 

1 .LNSSY Obtain the system definition of the logical name. 

LNMST ERROR MNEMONICS: 

GJFX22: Insufficient system resources (Job Storage Block full) 

LNSTX1: No such logical name 

LNSTX2: Invalid function 
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LOGIN JSYS 1 



Logs a job into the system. Useful for logging in from an idle 
terminal on which a CTRL/C has been typed. 



RESTRICTIONS: 

ACCEPTS IN AC1 
AC2 
AC3 



RETURNS 



When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

36-bit user number under which user will log in 

pointer to beginning of password string 

account number in bits 3-35 if bits 0-2 are 5. 
Otherwise contains a pointer to an account string. 
If a null byte is not seen, the string is terminated 
after 39 characters are processed. 

+1: failure, error code in AC1 

+2: success, date and time of last login (in internal 
system format; refer to Section 2.9.2) in AC1, and 
updated string pointers, if pertinent, in AC2 and 
AC3. 

The LOGIN monitor call does not require a password if the controlling 
terminal is a pseudo-terminal and the controlling job either has the 
WHEEL or OPERATOP. capability enabled or is logged in as the same user 
being logged in for this job. 

If the call is successful, an accounting entry is appended to the 

accounting data file. If the account validation facility is enabled, 

the LOGIN call verifies either the account given or the default 
account of the user being logged in. 

LOGIN ERROR MNEMONICS: 



LGINX1 
LGINX2 
LGINX3 
LGINX4 
LGINX5 
LGINX6 



Invalid account identifier 

Directory is "files-only" and cannot be logged in to 

Internal format of directory is incorrect 

Invalid password 

Job is already logged in 

No more job slots available for logging in 
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LPINI 



JSYS 547 



Loads the direct access Vertical Formatting Unit (VFU) or translation 
Random Access Memory (RAM) for the line printer. This call is 
executed at system startup by the program that configures the system. 



RESTRICTIONS: 
ACCEPTS IN AC1: 
AC2 



requires WHEEL or OPERATOR capabilities enabled 

JFN of file containing VFU or RAM 

status bits in the left half, and function code in 
the right half 



AC3: unit number of line printer 
RETURNS +1: always 
The following status bit is currently defined. 

B0(MO%LCP) Line printer is a lowercase printer 
The available functions are as follows: 
Code Symbol Meaning 

.MOLVF 



3 2 



3 4 



Load the VFU from the file indicated by the given 
JFN. 



.MOLTR Load the translation RAM from the file indicated 
by the given JFN. 



The line printer must not be opened by any process when this call is 
executed. If a condition occurs that prevents the VFU or RAM from 
being loaded (e.g., the line printer is off line), the name of the 
file will be stored. The VFU or RAM will then be loaded automatically 
the next time a process performs output to the line printer. 

Generates an illegal instruction interrupt on error conditions below. 

LPINI ERROR MNEMONICS: 



LPINX1 
LPINX2 
LPINX3 



Invalid unit number 

WHEEL or OPERATOR capability required 

Illegal to load RAM or VFU while device is OPEN 
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Transfers control to the MDDT program while preservii 
the process that issued the MDDT% JSYS. The tei 
activated and the user may enter commands to the MDD r 



RESTRICTIONS: requires WHEEL or OPERATOR capabilities enabled 

The MDDT% JSYS accepts no arguments. 

MDDT% ERROR MNEMONICS: 

WHELX1: WHEEL or OPERATOP capability required 
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METER% JSYS 766 

Returns the value of the execution accounting meter or the memory 
reference accounting meter. These values do not represent time as in 
"clock time"; rather, they represent the amount of time that the EBOX 
was busy and how many times the MBOX was referenced by the EBOX. 

RESTRICTIONS: available only on KL10 hardware 

ACCEPTS IN AC1: function code 

RETURNS +1: always, with 59-bit value in AC2 and AC3 

Function Codes: 

Code Symbol Meaning 

1 .MEREA Read process execution accounting meter 

doubleword. Value returned is EBOX busy time 
(number of EBOX ticks) . 

2 .MERMA Read process memory-reference accounting meter 

doubleword. Value returned is count of MBOX 
references (number of MBOX ticks) . 

The accounting meters have bits that allow executive PI overhead and 
executive non-PI overhead to be included in the doubleword count. 
These are turned off by default (the monitor must be rebuilt to set 
them), so (by default) the EBOX count does not include the monitor 
overhead of paging, scheduling, or swapping. The EBOX count primarily 
includes only the EBOX time spent executing the instructions and 
JSYS ' s in the user's program. 

Interrupts caused by 10, paging, swapping, and so on, can cause 
instruction restarts or require pager refills, and these are included 
in the count. Because these interrupts depend on a variety of system 
variables, such as load average, subsequent timings of the same event 
will return varying count values. These fluctuations can be 
"smoothed" by timing the event repeatedly and taking the average of 
the values returned. 

The MBOX reference count has the same specifications as the EBOX 
count, and is subject to the same kind of fluctuations. Cache hit/no 
hit introduces an additional source of fluctuations. Again, timing 
the event repeatedly and taking the average of the values returned 
will "smooth" the counts. 

An event can be timed by an initial execution of METER%, a DMOVEM 
instruction to save the start value, and (after the event) a second 
execution of METER% followed by a DSUB instruction to find the elapsed 
number of ticks. For added accuracy, the average overhead for the 
timing sequence can be determined and subtracted from the average 
count value for the timed interval. 

The following diagram illustrates the format of the value returned: 



AC2 
High Order Part 



AC3 



!0! Low Order Part ! Reserved 



35!0!1 



23124 



35! 
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Note that the following instruction changes the format of the values 
returned by the METER% call to form a r ight- justified doubleword value 
in AC2 and AC3. 

ASHC AC2,-~D12 

METER% ERROR MNEMONICS: 

ARGX02: Invalid function code 

METRX1: METER% not implemented for this processor 
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MRECV JSYS 511 

Retrieves an IPCF (Inter-Process Communication Facility) message from 
the process' input queue. Refer to the TOPS-20 Monitor Calls User's 
Guide for an overview and description of the Inter-Process 
Communication Facility. 

RESTRICTIONS : Requires WHEEL, OPERATOR or IPCF capability enabled 

ACCEPTS IN AC1: length of packet descriptor block 

AC2: address of packet descriptor block 

RETURNS +1: failure, error code in AC1 

+2: success. The packet is retrieved and placed into the 
block indicated by word .IPCFP of the packet 
descriptor block. AC1 contains the length of the 
next entry in the queue in the left half and the 
flags from the next packet in the right half. This 
returned word is called the associated variable of 
the next entry in the queue. If the queue is empty, 
AC1 contains 0. 

The format of the packet descriptor block is as follows: 

Word Symbol Meaning 

.IPCFL Flags. (Refer to the MSEND call 

description.) If bit IP%CFB Is set in this 
word, MRECV does not block until a packet is 
read . 

1 .IPCFS PID of sender. The caller does not supply 

this PID; the system fills it in when the 
packet is retrieved. 

2 .IPCFR PID of receiver. This PID can be one of 

three values: a specific PID, -1 to retrieve 
messages for any PID belonging to this 
process, or -2 to retrieve messages for any 
PID belonging to this job. When -1 or -2 is 
supplied, messages are not retrieved in any 
particular order except that messages from a 
specific PID are returned in the order in 
which they were received. 

3 .IPCFP Pointer to block where message is to be 

placed (length of message in the left half 
and address where message is to be placed in 
the right half) . 

4 .IPCFD User number of sender. 

5 .IPCFC Enabled capabilities of sender. 
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Word 


Symbol 


6 


.IPCSD 


7 


.IPC AS 



10 



.IPCLL 



Meaning 

Directory number of sender's connected 
d irectory . 

Account string of sender. The caller 
supplies a pointer to the block where the 
account is to be placed. 

Byte pointer to area to store logical 
location (node name) of sender. 



The caller (receiver) does not supply the information in words 4 
through 7; the system fills in the words when the packet is 
retrieved. These words describe the sender at the time the message 
was sent and permit the receiver to validate messages. If a byte 
pointer is supplied in word .IPCLL, the monitor will use it to return 
the ASCIZ string for the logical location of the sender. 

Refer to the MSEND call description for the flags that can be set in 
word .IPCFL of the packet descriptor block. 

MRECV ERROR MNEMONICS: 



IPCFX1 
IPCFX2 
IPCFX3 
IPCFX4 
IPCFX5 
IPCF11 
IPCF14 
IPCF15 
IPCF16 
IPCF24 
IPCF25 
IPCF26 
IPCF27 
IPCF28 
IPCF29 
IPCF31 
IPCF32 
IPCF3 4 



Length of packet descriptor block cannot be less than 4 

No message for this PID 

Data too long for user's buffer 

Receiver's PID invalid 

Receiver's PID disabled 

WHEEL or IPCF capability required 

No PID's available to this job 

No PID's available to this process 

Receive and message data modes do not match 

Invalid message size 

PID does not belong to this job 

PID does not belong to this process 

PID is not defined 

PID not accessible by this process 

PID already being used by another process 

Invalid page number 

Page is not private 

Cannot receive into an existing page 
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Sends an IPCF (Inter-Process Communication Facility) message. The 
message is in the form of a packet and can be sent to either the 
specified PID or the system process <SYSTEM>INFO. Refer to the 
TOPS-20 Monitor Calls User's Guide for an overview and description of 
the Inter-Process Communication Facility. 

RESTRICTIONS: Some functions require WHEEL, OPERATOR, or IPCF 
capability enabled. 

length of packet descriptor block 

address of packet descriptor block 

failure, error code in AC1 

success. The packet is sent to the receiver's input 
queue. Word .IPCFS of the packet descriptor block is 
updated with the sender's PID. This updating is done 
in case the PID was being defaulted or created by 
this call. 

The format of the packet descriptor block is as follows: 



ACCEPTS 


IN 


AC1 
AC2 


RETURNS 




+ 1 
+ 2 



Word 


Symbol 


n 


. IPCFL 


1 


.IPCFS 



Flags 



Meaning 
(See below. ) 



PID of sender; or address of PID if IP%CFS 
or IP%CFR is set in WORD .IPCFL; or if no 
PID exists for sender. This word will be 
filled in by the monitor if the caller is 
creating a PID (flag bit IP%CPD is on) . 



IPCFR 



PID of receiver , 
<SYSTEM>INFO. 



or 



if 



receiver 



is 



3 .IPCFP Pointer to message block (length of message 

in the left half and starting address of 
message in the right half). When a packet is 
sent to <SYSTEM>INFO, the message block 
contains the request being made. (See 
below . ) 

The following flags are defined in word .IPCFL of the packet 
descriptor block. These flags can be set on both the MSEND and MRECV 
calls. 

Flags Set By Caller 

B0(IP%CFB) Do not block process if there are no messages in the 
queue. If this bit is set, an error is given if there 
are no messages. 

B1(IP%CFS) Use, as the sender's PID, the PID obtained from the 
address specified in word .IPCFS. Setting bit IP%CFS 
notifies the monitor that word .IPCFS contains an 
address, and the sender's PID is located at that 
address . 
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B2(IP%CFR) Use, as the receiver's PID, the PID obtained from the 
address specified in word .IPCFR. Setting bit IP%CFP. 
notifies the monitor that word .IPCFR contains an 
address, and the receiver's PID is located at that 
address . 

B3(IP%CFO) Allow one send request above the quota. (The default 
send quota is 2 . ) 

B4(IP%TTL) Truncate the message, if it is larger than the space 
reserved. If this bit is not set, an error is given if 
the message is too large. 

B5(IP%CPD) Create a PID to use as the sender's PID and return it 
in word .IPCFS of the packet descriptor block. If flag 
IP%CFS is set, this function returns the created PID in 
the word to which the contents of .IPCFS points. 

B6(IP%JWP) Make the created PID be job wide (i.e., permanent until 
the job logs out). If this bit is not set, the PID is 
temporary until the process executes the RESET monitor 
call. If B5(IP%CPD) is not set, B6 is ignored. 

B7(IP%N0A) Do not allow other processes to use the created PID. 
If B5(IP%CPD) is not set, B7 is ignored. 

B18(IP%CFP) The packet is privileged. (This bit can be set only by 

a process with IPCF capability enabled.) When a 

privileged sender sets this bit, the MPECV and MUTIL 

calls return it set for any reply. An error is given 

if this bit is set by the sender and the receiver is 
not privileged. 

B19(IP%CFV) The packet is a page of data. Word . IPCFP of the 

packet descriptor block contains 1000 in the left half 

and the page number in the right half. The page the 
packet is being sent to must be private. 

B21(IP%INT) Reserved for Digital use 

B22(IP%EPN) Page number in word .IPCFP of the packet, descriptor 
block is 18 bits long. 

NOTE 

When a process sends a page of data with MSEND, 
that page is removed from the process' map. 



Flags Returned After Call 

B20(IP%CFZ) A zero-length message was sent, and the packet consists 
of only the packet descriptor block. 

B24-B29 Error code field for errors encountered by <SYSTEM>INFO 
(IP%CFE) during a send or receive request. Code Symbol Meaning 

15 . IPCPI insufficient privileges 

16 . IPCUF invalid function 

67 . IPCSN <SYSTEM>INFO needs name 

72 . IPCFF <SYSTEM>INFO free space exhausted 
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74 .IPCBP PID has no name or is invalid 

75 . IPCDN duplicate name has been specified 

76 .IPCNN unknown name has been specified 

77 .IPCEN invalid name has been specified 

B30-B32 System and sender code. This code can be set only by a 
(IP%CFC) process with IPCF capability enabled. The system 
returns the code so that a nonpr ivileged user can 
examine it. 

Code Symbol Meaning 

1 .IPCCC sent by <SYSTEM>IPCF 

2 .IPCCF sent by system-wide <SYSTEM>INFO 

3 .IPCCP sent by receiver's <SYSTEMMNFO 

B33-B35 Field for return of special messages. This field can 
(IP%CFM) be set only by a process with WHEEL capability enabled. 

The system returns the information so that a 

nonpr ivileged user can examine it. 

Code Symbol Meaning 

1 .IPCFN Process' input queue contains a packet 
that could not be delivered to intended 
PID. 

When the MSEND call is used to send a packet to <SYSTEM>INFO, the 
message portion of the packet (i.e., the first three words) contains 
the request. This request has the following format: 

Word Symbol Meaning 

.IPCIO user-defined code in the left half and the 

function (see below) <SYSTEM>INFO is to 
perform in the right half. The user-defined 
code is used to associate the response from 
<SYSTEM>INFO with the appropriate request. 

1 .IPCI1 PID that is to receive a duplicate of the 

response from <SYSTEM>INFO. If this word is 
0, the response is sent only to the 
originator of the request. 

2 .IPCI2 argument for the requested function. (See 

below. ) 

The functions that can be requested of <SYSTEM>INFO, along with their 
arguments, are as follows: 

Function Argument Meaning 

•IPCIW name Return the PID associated with the 

specified name. The PID is returned in 
word .IPCI1. 

. IPCIG PID Return the name associated with the 

specified PID. The name is returned in 
word .IPCI1. 
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Function 
.IPCII 



Argument 

name in 
ASCIZ 



.IPCIJ 



.IPCIK 



name in 
ASCIZ 

PID 



IPCFX6 
IPCFX7 
IPCFX8 
IPCFX9 
IPCF11 
IPCF12 
IPCF13 
IPCF14 
IPCF15 
IPCF19 
IPCF24 
IPCF25 
IPCF26 
IPCF27 



Meaning 

Assign the specified name to the PID 
belonging to the process making the 
request. The temporary or permanent 
status of the PID is specified by flag 
bit IP%JWP(B6) when the PID was 
originally created. 

Identical to the .IPCII function. 



Inform a PID when certain other PID's 
are deleted. The PID to be "watched" 
for deletion is placed in word .IPCI2. 
When that PID is deleted, SYSTEM INFO 
sends a message to the requesting PID 
with .IPCKM in the IP%CFE field, and the 
deleted PID in word .IPCII of the 
message. This function requires WHEEL 
or OPERATOR privileges. 

Disassociates all PIDs with names. Used 
by the monitor on a RESET or LGOUT 
monitor call. This function is not 
available to user programs. 



Length of packet descriptor block cannot be less than 4 
Receiver's PID invalid 
Receiver's PID disabled 



.IPCIS 

MSEND ERROR MNEMONICS 

IPCFX1 

IPCFX4 

IPCFX5 



Send quota exceeded 

Receiver quota exceeded 

IPCF free space exhausted 

Sender's PID invalid 

WHEEL or IPCF capability required 

No free PID's available 

PID quota exceeded 

No PID's available to this job 

No PID's available to this process 

No PID for [SYSTEM] INFO 

Invalid message size 

PID does not belong to this job 

PID does not belong to this process 

PID is not defined 
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IPCF28: PID not accessible by this process 

IPCF29: PID already being used by another process 

IPCF31: Invalid page number 

IPCF32: Page is not private 
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MSFRK JSYS 312 

Starts a process in monitor mode. This call allows job to create 
multiple processes for handling various asynchronous monitor tasks. 

RESTRICTIONS: requires WHEEL or OPERATOR capability enabled, or 
execution from monitor mode 

ACCEPTS IN AC1: process handle 

AC2: 36-bit PC word, with user mode and other flags in the 
left half and the virtual address in the right half 

RETURNS +1: always 

Because the starting context of the process is undefined, the process 
being started should execute the following sequence of instructions at 
its starting address: 

FBGN: MOVSI l,UMODF ;fake user PC 

MOVEM 1,FPC ; simulate the JSYS call 

MCENTR .-establish usual top-level JSYS context 

Generates an illegal instruction interrupt on error conditions below. 

MSFRK ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 

CAPX1: WHEEL or OPERATOR capability required 
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MSTR JSYS 555 

Performs various structure-dependent functions. These functions 
include mounting and dismounting structures, incrementing and 
decrementing mount counts for structures, and setting and obtaining 
the status of structures. 

For regulated structures, the mount count must be incremented before 
access rights or JFNs can be given. All structures are regulated by 
default except the primary structure (PS: on most systems) or any 
structure declared non-regulated with the .MSSSS function of MSTR. 



RESTRICTIONS: some functions require WHEEL, OPERATOR, or 
MAINTENANCE capability enabled. 

ACCEPTS IN AC1: length of the argument block in the left half and 
function code in the right half 

AC2: address of the argument block 

RETURNS +1: always, with some functions returning data in the 
argument block. (Refer to individual function 
descriptions below.) 

Generates an illegal instruction interrupt on all error conditions. 

The available functions are summarized below. 

d Meaning 

Return the status of the next 
disk unit. 

Return the status of the given 
disk unit. 

Mount the given structure. 

Dismount the given structure. 

Return the status of the given 
structure. 

5 .MSSSS Yes Change the status of the given 

structure . 

6 .MSINI Yes Initialize the given 

structure. 

7 .MSIMC No Increment the mount count for 

the given structure for the 
job. 

10 .MSDMC No Decrement the mount count for 

the given structure for the 
job. 
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Function 


Symbol 


Pr 


ivil 


Code 











•MSRNU 




Yes 


1 


.MSRUS 




Yes 


2 


.MSMNT 




Yes 


3 


.MSDIS 




Yes 


4 


.MSGSS 




No 
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Function 
Code 



Symbol 



Pr ivileged 



Meaning 



11 



12 



13 



14 



15 



16 



MSGSU 



MSHOM 



MSICF 



MSDCF 



MSOFL 



MS IIC 



No 



Yes 



No 



No 



Yes 



Yes 



Return the job numbers of the 
users of the given structure. 

Modify the home block of the 
given structure. 

Increment the mount count for 
the given structure for the 
given fork. 

Decrement the mount count for 
the given structure for the 
given fork. 

Receive interrupt when disk 
comes on-line. 

Ignore increment check for 
structure use 



Obtaining the Status of the Next Disk Unit 



.MSRNU 



This function returns the status of the next disk unit on the system. 
The next disk unit is determined by searching the current channel and 
looking for the next physical unit on that channel. 

The .MSRNU function accepts the channel, controller, and unit numbers 
in the first three words of the argument block. The first time this 
function is executed, the value for each of these numbers is -1. 
After successful completion of this function, the channel, controller, 
and unit numbers are updated, and the software information about the 
disk drive is returned in the argument block. To locate all drives 
available for mounting structures, the channel, controller, and unit 
numbers returned from one .MSRNU function call are supplied on the 
next one until all units on all channels have been searched. When all 
units have been searched, the MSTR monitor call returns error MSTX18. 



The format of the argument 
follows : 



block, v/hose length is .MSRLN, is as 



Word Symbol 

.MSRCH 

1 .MSRCT 

2 .MSRUN 

3 .MSRST 



Meaning 

Channel number (0-7) 

Controller number 

Unit number (0-7) 

Returned software status of unit 
following status bits are defined: 

of a 



The 



mounted 



B0(MS%MNT) Unit is part 

structure 
B2(MS%DIA) Unit is being used by an on-line 

diagnostic program 
B3(MS%OFL) Unit is off line 
B4(MS%ERR) Unit has an error that was 

detected during reading 
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Word Symbol Meaning 

3 .MSRST B5(MS%BBB) Unit has a bad BAT block. If 

(Cont.) this bit is on, the data returned 

in word .MSRSN (word 4) and in 
words .MSRNS through .MSRFI 
(words 6 through 20) is 
indeterminate . 
B6(MS%HBB) Unit has a bad HOME block 
B7(MS%WLK) Unit is write locked 
B9-B17 Type of disk unit 



10- 


-12 


.MSRUI 


13- 


-15 


•MSROI 


16- 


-20 


•MSRFI 


21 




.MSRSP 


22 




.MSRSC 


23 




•MSRPC 


24 




.MSRCU 


25 




.MSRSU 


26 




.MSRBT 


27 




.MSRSE 



(MS%TYP) 










1 


•MSRP4 


RP04 




5 


.MSRP5 


RP05 




6 


.MSRP6 


RP06 




7 


•MSRP7 


RP07 




11 


.MSRM3 


RM03 




24 


.MSR20 


RP20 



.MSRSN Byte pointer to ASCIZ string in which to 

store the structure name. This pointer is 
updated on return. 

.MSRSA Byte pointer to ASCIZ string in which to 
store the structure alias. The alias is 
usually the same as the structure name. The 
alias is returned, and the pointer updated, 
only if the structure is on line. 

.MSPNS Logical unit number within the structure of 
this unit in the left half, and number of 
units in the structure in the right half. 

. MSRSW Number of pages for swapping on this 

structure . 

Unit ID (3 words of 11-formatted ASCII) 

Owner ID (3 words of 11-formatted ASCII) 

File system ID (3 words of 11-formatted 
ASCII) 

Number of sectors per page 

Number of sectors per cylinder 

Number of pages per cylinder 

Number of cylinders per unit 

Number of sectors per unit 

Number of bit words in bit table per cylinder 

Serial number of the CPU for which the 
structure is used in booting the system 

The length of the argument block in words is given by symbol .MSRLN 
(30) . 
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The 11-formatted ASCII mentioned above is 7-bit ASCII stored four 
bytes to a 36-bit word in a format similar to that of a PDP-11: 



!XX! 


CHAR 1 


! CHAR 


!XX! 


CHAR 3 


! CHAR 2 ! 


!XX! 


CHAR 5 


CHAR 4 


!XX! 


CHAR 7 


! CHAR 6 ! 


!XXi 


CHAR 9 


CHAR 8 


IXX1 


CHAR 11 


1 CHAR 10 1 



The following errors are possible on the failure of this function. 



MSTRX2 
MSTRX3 
MSTX14 
MSTX15 
MSTX16 
MSTX18 
MSTX27 
CAPX2: 



WHEEL or OPERATOR capability required 

argument block too small 

invalid channel number 

invalid unit number 

invalid controller number 

no more units in system 

specified unit is not a disk 

WHEEL, OPERATOR, or MAINTENANCE capability required 



Obtaining the Status of a Given Disk Unit - .MSRUS 

This function returns the status of the given disk unit. It accepts 
the channel, controller, and unit numbers in the first three words of 
the argument block., After successful completion of this function, the 
channel, controller, and unit numbers are unchanged, and the software 
information about the given disk unit is returned in the argument 
block . 

The difference between this function and the .MSRNU function is that 
.MSRUS does not search for the next disk unit but rather returns the 
status for the given unit. The .MSRNU function searches for the next 
disk unit and returns the status for that unit. 

The format of the argument block and the errors possible on the 
failure of this function are the same as described for the .MSRNU 
function . 

Mounting a Given Structure - .MSMNT 

This function brings the given structure on line and normally makes it 
available for general use. Any structure other than the public 
structure (usually called PS:) must be brought on line with this 
function. (The public structure is brought on line during the system 
startup procedure.) 
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It is recommended that the .MSRNU (Read Next Unit) function be given 
first to locate all units in the structure. Then the . MSMNT (Mount 
Structure) function can be given to read and verify the HOME blocks of 
each unit and to mount the structure. If one or more units of the 
structure are wr ite-locked , the structure cannot be mounted and an 
error is given. 

The format of the argument block is as follows: 

Word Symbol Meaning 

.MSTNM Pointer to the ASCIZ string containing the 

name of the structure. 

1 .MSTAL Pointer to the ASCIZ string containing the 

alias of the structure. 

2 .MSTFL Flag bits in the left half, and the number of 

units in the structure (.MSTNU) in the right 

half. The bits that can be set in the left 

half are: 

B0(MS%NFH) If one of the HOME blocks is 
incorrect, do not fix it, but do 
return an error. If one of the 
HOME blocks is incorrect and this 
bit is off, the correct block is 
copied into the bad HOME block, 
and the mounting procedure 
continues . 

B1(MS%NFB) If one of the BAT (Bad Allocation 
Table) blocks is incorrect, do 
not fix it and do return an 
error. If this bit is off and 
one of the BAT blocks is 
incorrect, the correct block is 
copied into the bad BAT block and 
the mounting procedure continues. 

B2(MS%XCL) Mount the structure for exclusive 
use by this job. This bit is set 
by a system program when it 
initializes or reconstructs a 
structure. If this bit if off, 
the structure is mounted for 
general use. 

B3(MS%IGN) Ignore correctable errors in the 
bit table and in the root 
directory on this structure. 
This bit is set by a system 
program when it reconstructs the 
root directory on a structure or 
rebuilds the bit table. If this 
bit is off and an error is 
detected, this function returns 
an error . 
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Word Symbol 
3 .MSTUI 



Meaning 

Beginning of unit information for each unit 
in the structure. The information is 3 words 
long per unit, and the symbol for this length 
is .MSTNO. The first 3-word block is for 
logical unit 0, and the last 3-word block is 
for the last logical unit (.MSTNU-1). The 
offsets into the 3-word block are: 

.MSTCH Channel number of unit 

1 .MSTCT Controller number of unit 

(currently must be -1) 

2 .MSTUN Unit number of unit 

The number of argument words per unit is 
given by symbol .MSTNO (3). 

After successful completion of this function, the given structure is 
mounted and available for general use (unless bit MS%XCL was on in 
word .MSTFL of the argument block). The following errors are possible 
on the failure of this function. 



MSTRX2 
MSTRX3 
MSTRX4 
MSTRX5 
MSTRX6 
MSTRX7 
MSTRX8 
MSTRX9 
MSTX10 
MSTX11 
MSTX12 
MSTX13 
MSTX14 
MSTX15 
MSTX16 
MSTX17 
MSTX19 
MSTX20 
MSTX23 



WHEEL or OPERATOR capability required 

argument block too small 

insufficient system resources 

drive is not on line 

home blocks are bad 

invalid structure name 

could not get OFN for ROOT-DIRECTORY 

could not MAP ROOT-DIRECTORY 

ROOT-DIRECTORY bad 

could not initialize Index Table 

could not OPEN Bit Table File 

backup copy of ROOT-DIRECTORY is bad 

invalid channel number 

invalid unit number 

invalid controller number 

all units in a structure must be of the same type 

unit is already part of a mounted structure 

data error reading HOME blocks 

could not write HOME blocks 
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MSTX2 5 
MSTX27 
MSTX30 
MSTX34 
MSTX35 
MONX01 



invalid number of swapping pages 

specified unit is not a disk 

incorrect Bit Table counts on structure 

unit is write-locked 

too many units in structure 

insufficient system resources 



Dismounting a Given Structure - .MSDIS 

This function indicates that the given structure can be removed from 
the system. Any mounted structure other than the public structure 
(usually called PS:) can be dismounted with this function. (The 
public structure is dismounted at system shutdown.) 

Files that are open at the time this function is executed become 
inaccessible, and the jobs that had the files open receive an error if 
they reference them. Jobs that have mounted the structure or have 
connected to or accessed a directory on the structure receive an 
informational message on the terminal. This message is 

[STRUCTURE name: HAS BEEN DISMOUNTED] 

The format of the argument block is as follows: 

Word Symbol Meaning 

.MSDNM Pointer to ASCIZ string containing the alias 

of the structure, or device designator of the 
structure . 

After successful completion of this function, the given structure is 
dismounted and can be physically removed from the system. 

The following errors are possible on the failure of this function. 



MSTRX2 
MSTRX3 
MSTX21 
MSTX24 



WHEEL or OPERATOR capability required 

argument block too small 

structure is not mounted 

illegal to dismount the Public Structure 



Obtaining the Status of a Given Structure - .MSGSS 

This function returns the status of a mounted structure. The caller 
supplies the designators for the structure and for the storage of the 
structure's physical ID. After successful completion of the call, 
data is returned in the appropriate words in the argument block. 
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The format of the argument block, whose length is .MSGLN, is as 
follows: 



Word 




Symbol 
.MSGSN 

.MSGST 



.MSGNU 
.MSGMC 



.MSGFC 



.MSGSI 



Meaning 

Byte pointer to ASCIZ string containing the 
alias of the structure, or device designator 
of the structure. 

Returned status word. The status bits are: 

B0(MS%PS) This structure is a public 
structure . 

B1(MS%DIS) This structure is being 
dismounted and no further mount 
count increments are allowed. 



B2(MS%DOM) This structure is a 
structure. 



domestic 



B3(MS%PPS) This structure is the public 
structure. 



B4(MS%INI) This structure 
initialized. 



is 



being 



B5(MS%LIM) Directories on this structure are 
limited to the size of a 
directory on a DECSYSTEM-2050 (30 
pages) . 

B6(MS%NRS) Structure is non-regulated. 

Number of units in structure. 

Mount count for this structure. This value 
is determined by the number of .MSIMC 
(Increment Mount Count) functions given for 
this structure by all users since the 
structure was mounted. 

Open file count (i.e., number of open files) 
for this structure. 

Pointer to ASCIZ string in which to store the 
structure's physical ID. 



The length of the argument block is given by symbol .MSGLN (6). 

After successful completion of this function, the status of the given 
structure is returned in the appropriate words of the argument block, 
and the pointer to the physical ID is updated to reflect the returned 
string . 

The following errors are possible on the failure of this function. 

MSTRX3: argument block too small 

MSTX21: structure is not mounted 
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Changing the Status of a Given Structure - .MSSSS 

This function changes the status of a mounted structure. The caller 
can change four of the status bits in the structure's status word: 
the status of being dismounted, the status of being domestic, the 
status of having read-af ter-wr ite checking done in the swapping area 
of the disk, and the status of having read-af ter-wr ite checking done 
in the data area. 

The format of the argument block, the length of which is .MSSLN, is: 



Word 




Symbol 
.MSSSN 

.MSSST 
.MSSMW 



Meaning 

Byte pointer to ASCIZ string containing the 
alias of the structure, or device designator 
of the structure. 

Word containing the new values for the bits 
being changed. 

Mask containing the bits being changed. The 

bits that can be changed are: 

B1(MS%DIS) Structure is being dismounted. 

B2(MS%D0M) Structure is domestic. 

B6(MS%NRS) Structure is non-regulated. 

B7(MS%RWS) Read-af ter-wr ite checking is 
being done in the swapping area 



B8(MS%RWD) Read-af ter-write checking 
being done in the data area 



is 



After successful completion of this function, the status of the given 
structure is changed according to the data supplied in the argument 
block . 

The following errors are possible on the failure of this function. 



MSTRX2 
MSTRX3 
MSTX21 
MSTX22 



WHEEL or OPERATOR capability reguired 
argument block too small 
structure is not mounted 
illegal to change specified bits 



Initializing a Given Structure - .MSINI 

This function creates a new structure or repairs an existing structure 
during normal system operation. The caller has the option of creating 
a new file system, reconstructing the root directory, writing a new 
set of HOME blocks on the structure, or rebuilding the index block. 
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The format of the argument block is as follows: 

Word Symbol Meaning 

.MSINM Byte pointer to ASCIZ string containing the 

name of the structure. 

1 .MSIAL Byte pointer to ASCIZ string containing the 

alias of the structure. 

2 .MSIFL Flag bits in B0-B11, function value (MS%FCN) 

in B12-B17, and number of units in structure 
(.MSINU) in B18-B35. The flag bits are: 

B0(MS%NFH) Do not fix HOME block if one is 
incorrect and do return an error. 
This bit can be on only with 
function .MSRRD. (See below.) 

Bl (MS%NFB) Do not fix BAT block if one is 
incorrect and do return an error. 

B2(MS%XCL) Mount this structure for 
exclusive use by this job. If 
this bit is off, the structure is 
mounted for general use. 

B3(MS%IGN) Ignore errors in the bit table 
and in the root directory on this 
structure. If this bit is on, 
B2(MS%XCL) must also be on. 

The function values that can be given are: 

1 .MSCRE Create a new file system 

2 .MSRRD Reconstruct the root directory 

3 .MSWHB Write a new set of HOME blocks 

4 .MSRIX Rebuild the index table 

3-5 .MSISU Beginning of unit information for each unit 

in the structure. The information is 3 words 
long per unit, and the symbol for this length 
is .MSINO. The first 3-word block is for 
logical unit 0, and the last 3-word block is 
for the last logical unit (.MSINU-1). The 
offsets into the 3-word block are: 

.MSICH Channel number of unit 

1 .MSICT Controller number of unit 

(currently must be -1) 

2 .MSIUN Unit number of unit 

The number of arguments per unit is given by 
symbol .MSINO (3) . 

6 .MSIST Status word (reserved for future use) . 

7 .MSISW Number of pages for swapping on this 

structure. 
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Word Symbol 

10 . MSIFE 

11-13 .MSIUI 

14-16 .MSIOI 

17-21 .MSIFI 



Meaning 

Number of pages for the front-end file 
system. 

Unit ID (3 words of ASCII) 

Owner ID (3 words of ASCII) 

File system ID (3 words of ASCII) (reserved 
for future use) 

22 .MSIFB Number of pages for the file BOOTSTRAP.BIN. 

23 .MSISN Serial number of the CPU for which this 

structure is used in booting the system. You 
must supply this word when creating a system 
structure that does not have the name PS:. 

Words 6 through 16 (.MSIST through .MSIOI) of the argument block must 
be supplied when the MSTR call is being executed to create a new file 
system or to write a new set of HOME blocks. After successful 
completion of the .MSCRE function, the structure is initialized and 
the following directories are created: 

<ROOT-DIRECTORY> 

<SYSTEM> 

<SUBSYS> 

<ACCOUNTS> 

<SPOOL> 

<OPERATOR> 

<SYSTEM-ERROR> 

The following errors are possible on the failure of this function. 



MSTRX2 
MSTRX3 
MSTRX4 
MSTRX5 
MSTRX6 
MSTRX7 
MSTRX8 
MSTRX9 
MSTX10 
MSTX11 
MSTX12 
MSTX13 
MSTX14 
MSTX15 



WHEEL or OPERATOR capability required 

argument block too small 

insufficient system resources 

drive is not on line 

home blocks are bad 

invalid structure name 

could not get OFN for ROOT-DIRECTORY 

could not MAP ROOT-DIRECTORY 

ROOT-DIRECTORY bad 

could not initialize Index Table 

could not OPEN Bit Table File 

backup copy of ROOT-DIRECTORY is bad 

invalid channel number 

invalid unit number 
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MSTX16 
MSTX17 
MSTX19 
MSTX20 
MSTX23 
MSTX25 
MSTX26 
MSTX27 
MSTX28 
MSTX29 
MSTX30 
MONX01 



invalid controller number 

all units in a structure must be of the same type 

unit is already part of a mounted structure 

data error reading HOME blocks 

could not write HOME blocks 

invalid number of swapping pages 

invalid number of Front-End-File system pages 

specified unit is not a disk 

could not initialize Bit Table for structure 

could not reconstruct ROOT-DIRECTORY 

incorrect Bit Table counts on structure 

insufficient system resources 



Incrementing the Mount Count for the Job - .MSIMC 

Users indicate that they are actively using a structure by 
incrementing the structure's mount count. A nonzero mount count 
informs the operator that the structure should not be dismounted. 
Also, an IPCF message is sent to the Mountable Device Allocator to 
indicate that a user is using the structure. The .MSIMC function is 
used to increment a structure's mount count. 

Note that incrementing the mount count is a requirement for accessing 
files and directories on regulated structures. 

The job receives an error if the given structure is in the process of 
being dismounted (i.e., a job has given the .MSSSS function with the 
MS%DIS bit on) , or if the job is not logged in. 

The format of the argument block is as follows: 



Word Symbol 



MSDEV 



MSJOB 



Meaning 

Device designator, or byte pointer to ASCIZ 
string containing the alias of the structure. 

(Optional) Number of job (other than the 

current job) whose mount count is to be 

incremented. This requires WHEEL or OPERATOR 
capability to be enabled. 

After successful completion of this function, the mount count of the 
given structure has been incremented. 

The following errors are possible on the failure of this function. 

ARGX18: invalid structure name 

CACTX2: Job is not logged in 

L0UTX2: Invalid job number 
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MSTRX3 
MSTX21 
MSTX31 
MSTX33 
MONX01 
STDVX1 
STRX01 
STRX02 



argument block too small 

structure is not mounted 

structure already mounted 

structure is unavailable for mounting 

insufficient system resources 

no such device 

structure is not mounted 

insufficient system resources 




.MSDEV Device designator, or byte pointer to ASCIZ 

string containing the alias of the structure. 

1 .MSJOB (Optional) Number of job (other than the 

current job) whose mount count is to be 
decremented. This requires WHEEL or OPERATOR 
capability to be enabled. 

The resource allocator receives an IPCF packet when the mount count 
for a structure is decremented. The flag word (.IPCFL) of the packet 
descriptor block has a code of l(.IPCCC) in the IP%CFC field (bits 
30-32). This code indicates the message was sent by the monitor. The 
first word of the packet data block contains the structure dismount 
code .IPCDS. The second word contains the number of header words and 
the number of the job decrementing the mount count. The third word 
contains the device designator of the structure. Thus, 

• IPCFL/<.IPCCOB32 

DATA/. IPCDS 

DATA+1/number of header words (2),, job number 

DATA+2/device designator of structure 

After successful completion of this function, the mount count of the 
structure has been decremented and the IPCF message has been sent. 

The following errors are possible on the failure of this function. 

MSTRX3: argument block too small 

MSTX21: structure is not mounted 
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MSTX32 
MSTX36 
MSTX37 
ARGX18 
MONX01 
STDVX1 
STRX01 
STRX02 



structure was not mounted 

illegal while JFNs assigned 

illegal while accessing or connected to a directory 

invalid structure name 

insufficient system resources 

no such device 

structure is not mounted 

insufficient system resources 



Obtaining the Users on a Given Structure - .MSGSU 

This function returns the job numbers of the users of the given 
structure. Users of a structure are divided into three classes: 
users who have incremented the mount count (SMOUNT command), users who 
are connected to the structure (CONNECT command), and users who have 
accessed the structure (ACCESS command) . The caller specifies the 
classes of users for which information is to be returned by setting 
the appropriate bits in the argument block. 

The format of the argument block is as follows: 



Word 




Symbol 
.MSUAL 

.MSUFL 



Meaning 

Byte pointer to ASCIZ string containing the 
alias of the structure, or device designator 
of the structure. 

Flag bits in the left half and in the right 
half. The bits that can be set are: 

B0(MS%GTA) Return users who have accessed 
the structure. 

Bl (MS%GTM) Return users who have incremented 
the mount count. 

B2(MS%GTC) Return users who are connected to 
the structure. 

After successful execution of this function, word 1 through word n+1 
(where n is the number of items returned) are updated with the 
following information. 



Word Symbol 

1 .MSUFL 

2 .MSUJ1 



Meaning 

Right half contains the number of items (n) 
being returned. Left half is unchanged. 

Flag bits for the job in the left half, and 
number of job in the right half. 
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Word Symbol Meaning 

n + 1 Flag bits for the job in the left half, and 

number of job in the right half. 

The bits returned for each job are defined 
as : 

B0(MS%GTA) Job has accessed structure. 

B1(MS%GTM) Job has incremented the mount 
count for structure. 

B2(MS%GTC) Job has connected to structure. 

The following errors are possible on the failure of this function. 



MSTRX1 
MSTRX3 
STRX01 
STDVX1 
ARGX18 
MONX01 



invalid function 
argument block too small 
structure is not mounted 
no such device 
invalid structure name 
insufficient system resources 



Specifying Word and Bits To Be Modified 



.MSHOM 



This function allows enabled WHEEL or OPERATOR program to specify word 
of homeblock of mounted structure to be modified, which bits should be 
modified, and what the new values should be. 

The format of the argument block is as follows: 

Meaning 

Handle on alias such as pointer to string, or 
device designator. 

Offset specifying which word should be 
changed . 

Value for new bits. 

Mask showing which bits should be changed. 

The following errors are possible on the failure of this function: 



Word 


Symbol 





.MSHNM 


1 


.MSHOF 


2 


.MSHVL 


3 


.MSHMK 



MSTRX2 
MSTPX3 
MSTX21 



insufficient privileges 
argument block too small 
structure not mounted 



any errors "MODHOM" routine returns 
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Incrementing the Mount Count for the Fork - .MSICF 

This function and the next (.MSDCF) allow job forks to independently 
mount and dismount structures without contending with one another for 
control of the structure. (This is primarily intended for SYSJOB.) 
Note that when either a job mount or fork mount is possible, the job 
mount is preferred as it incurs less overhead. 

This function indicates that a fork is actively using a structure. If 
the structure is being dismounted", the job receives an error. The 
format of the argument block is: 



Word Symbol 
.MSDEV 



Meaning 

Pointer to ASCIZ string containing the alias 
of the structure, or device designator of the 
structure . 



The following errors are possible on the failure of this function. 



MSTRX3 
MSTX21 
MSTX33 
ARGX18 
MONX01 
STDVX1 
STRX01 
STRX02 



argument block too small 

structure is not mounted 

structure is unavailable for mounting 

invalid structure name 

insufficient system resources 

no such device 

structure is not mounted 

insufficient system resources 



Decrementing the Mount Count for the Fork - .MSDCF 

This function indicates that a fork is no longer using a structure. 

Note that if a job-wide increment has been done, the fork may still 

access the structure. The format of the argument block is: 



Word Symbol 
.MSDEV 



Meaning 

Pointer to ASCIZ string containing the alias 
of the structure, or device designator of the 
structure. 



The following errors are possible on the failure of this function. 



MSTRX3 
MSTX21 
MSTX32 
MSTX36 
MSTX37 
ARGX18 



argument block too small 

structure is not mounted 

structure was not mounted 

illegal while JFNs assigned 

illegal while accessing or connected to a directory 

invalid structure name 
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MONX01 
STDVX1 
STRX01 
STRX02 



insufficient system resources 
no such device 
structure is not mounted 
insufficient system resources 



Receiving Interrupt when Disk Comes On-line - .MSOFL 

This function specifies who is to receive an interrupt when a disk 
comes on-line. It is provided for the Mountable Device Allocator in 
order to control the disks and inform the operator of structure 
status. Only one process on the system will receive the interrupts. 
The process using this JSYS must have WHEEL or OPERATOR capability 
enabled. The argument block has the following format: 



Word Symbol 



.MSCHN 



Meaning 

Place this process on a software interrupt 
channel. An interrupt is then generated when 
a disk comes on-line. If the channel number 
is given as -1, a previously assigned 
interrupt channel will be deassigned. 



Ignoring Increment Check for Structure Use - .MSIIC 

Allows a process to use a regulated structure without previously 
incrementing the mount count. Entries are made to the accounting file 
only on structure decrements, so this function will enable bypassing 
of accounting. 

There is no argument block. 

The following errors are possible: 

MSTRX2: WHEEL or OPERATOR capability required 
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MTALN 



JSYS 774 



Associates a given serial-numbered magnetic tape drive with the 
specified logical unit number. The MTALN call is a temporary call and 
may not be defined in future releases. 

RESTRICTIONS: requires WHEEL or OPERATOR capability enabled 

ACCEPTS IN AC1: slave type in left half; logical unit number of 
magtape in right half 

AC2: decimal serial number of magnetic tape drive 

RETURNS +1: always 

All units are searched for the specified serial number and slave type. 
When they are found, the drive is associated with the given logical 
unit number. The original unit is now associated with the logical 
unit number that the specified serial-numbered drive had before it was 
reassigned. 

The slaves recognized are 

.MTT45 TU45 (The system default) 

.MTT70 TU70 

.MTT71 TU71 

.MTT72 TU72 

.MTT77 TU77 

.MTT78 TU78 

Generates an illegal instruction interrupt on error conditions below. 

MTALN ERROR MNEMONICS: 

WHELX1: WHEEL or OPERATOR capability required 

DEVX1: Invalid device designator 

OPNX7: Device already assigned to another job 
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MTOPR JSYS 77 



Performs various device-dependent control functions. This monitor 
call requires either that the JFN be opened or the device be assigned 
to the caller if the device is an assignable device. 

Because of the device dependencies of the MTOPR call, programs written 
with device-independent code should not use this call unless they 
first check for the type of device. 



RESTRICTIONS: 

ACCEPTS IN AC1 
AC2 
AC3 



some functions require WHEEL or OPERATOR capability 
enabled. Some functions require ARPANET or DECnet 
software. 

JFN of the device 

function code (see below) 

function arguments or address of argument block (see 
descriptions of individual devices) 



RETURNS 



+1: always 



The functions listed for each device apply only to that device. If a 

function applies to more than one device, its description is repeated 
for each applicable device. 

ARPANET Functions 

ARPANET MTOPR functions are described below. For a complete 

description of their application, refer to the ARPANET manual. 



Code 
20 

21 

22 
24 



Symbol 
.MOACP 

.MOSND 

.MOSIN 
.MOAIN 



Meaning 

If a connection is in the RFCR state, use of this 
function will cause an RFC to be sent to accept 
the connection. 

If a connection is operating in buffered send 
mode, use of this function causes all currently 
buffered bytes to be sent. 

Causes the INS/INR command to be sent. 

Assigns interrupt channels through which the 
program is interrupted on either a change of state 
(of the connection F.S.M) or receipt of an INS or 
INR message. The INS/INR PSI channel is stored in 
field MO%NIN (BO-5) of AC3 and the state change 
PSI channel is stored in field MO%FSM (B12-17) of 
AC3. A value of 77 (octal) in either of these 
fields prevents assignment of a PSI channel. 



DECnet Functions 



DECnet-20 MTOPR functions are described below. For a complete 
description of their application, refer to the DECnet manual. 
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Code 
24 



25 



Symbol Meaning 

.MOACN Allow a network task to enable software interrupt 
channels for any combination of the following work 
types: 

• connect event pending 

• interrupt message available 

• data available 

This function requires that AC3 contain three 
9-bit fields specifying the changes in the 
interrupt assignments for this link. These fields 
are: 

Field Symbol Used to Signal 

B0-B8 MO%CDN Connect event pending 
B9-B17 MO%INA Interrupt message available 
B18-B26 MO%DAV Data available 

The contents of the fields are 

Value Meaning 

nnn The number of the channel to be enabled; 

0-5 and 23-35 decimal 
.MOCIA Clear the interrupt 
.MONCI No change 

.MORLS Read the link status and return a 36-bit word of 
information regarding the status of the logical 
link. AC3 contains flag bits in the left half and 
a disconnect code in the right half. The flag 
bits are 



Symbol 



MO%CON 


BO 


MO%SRV 


Bl 


MO%WFC 


B2 


MO%WCC 


B3 


MO%EOM 


B4 


MO%ABT 


B5 


MO%SYN 


B6 


MO%INT 


B7 


MO%LWC 


B8 



Bit Meaning 

Link is connected 

Link is a server 

Link is waiting for a 

connection 

Link is waiting for a 

connection confirmation 

Link has an entire message to 

be read 

Link has been aborted 

Link has been closed normally 

Link has an interrupt message 

available 

Link has been previously 

connected 



The disconnect/reject codes are as follows: 
Symbol Value Meaning 



.DCXO 
.DCX1 
.DCX2 

.DCX3 
.DCX4 



No special error 

Resource allocation failure 

Destination node does not 

exist 

Node shutting down 

Destination process does not 

exist 
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25 



MORLS (Cont.) 



26 



27 



Symbol 

.DCX5 

.DCX7 
.DCX8 
.DCX9 

.DCX11 
.DCX21 

.DCX22 

.DCX23 

.DCX24 
.DCX32 
.DCX33 

.DCX34 
.DCX35 
.DCX36 
.DCX37 
.DCX38 
.DCX39 
.DCX40 
.DCX41 

.DCX42 

.DCX43 



Value Meaning 



5 

7 
8 
9 

11 
21 

22 

23 

24 
32 
33 

34 
35 
36 
37 
38 
39 
40 
41 

42 

43 



Invalid name field Destination 

process queue overflow 

Unspecified error 

Third party aborted link 

User abort (asynchronous 

disconnect) 

Undefined error code 

Connect initiate with illegal 

destination address 

Connect confirm with illegal 

destination address 

Connect initiate or connect 

confirm with zero source 

address 

Flow control violation 

Too many connections to node 

Too many connections to 

destination process 

Access not permitted 

Logical link services mismatch 

Invalid account 

Segment size too small 

Process aborted 

No path to destination node 

Link aborted due to data loss 

Destination process does not 

exist 

Confirmation of disconnect 

initiate 

Image data field too long 



If a disconnect code does not apply to the current 
status of the link, the right half of AC3 will be 
zero. 

MORHN Return the ASCII name of the host node at the 
other end of the logical link. This function 
requires that AC3 contain a string pointer to the 
location where the host name is to be stored. (If 
the byte size exceeds eight bits, bytes are 
truncated to eight bits.) 

The monitor call returns with an updated pointer 
in AC3, and the host name stored as specified. 

MORTN Return the unique task name that is associated 
with your end of the logical link. If you had 
defaulted the task name in the network file 
specification, the call returns the 
monitor-supplied task name. In DECnet-20, the 
default task name is actually a unique number. 

This function requires that AC3 contain a string 
pointer to the location where the task name is to 
be stored. (If the byte size exceeds eight bits, 
bytes are truncated to eight bits.) 

The monitor call returns with an updated pointer 
in AC3 and the task name stored as specified. 
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32 



33 
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Symbol Meaning 

.MORUS Return the source task user identification 
supplied in the connect initiate message. This 
function requires that AC3 contain a string 
pointer to the location where the user 
identification is to be stored. (If the byte size 
exceeds eight bits, bytes are truncated to eight 
bits. ) 

The monitor call returns with an updated pointer 
in AC3 and the user identification stored as 
specified. If no user identification was supplied 
by the source task, AC3 continues to point to the 
beginning of the string, and a null is returned as 
the only character. 

.MORPW Return the source task's password as supplied in 
the connect initiate message. This function 
requires that AC3 contain a string pointer to the 
location where the password is to be stored. 
(Passwords are binary; therefore, the string 
pointer should accomodate 8-bit bytes.) 

The monitor call returns with an updated pointer 
in AC3 and the source task's password stored as 
specified. AC4 contains the number of bytes in 
the string; a zero value indicates that no 
password was supplied by the source task. 

.MORAC Returns the account string supplied by the source 
task in the connect initiate message. This 
function requires that AC3 contain a string 
pointer to the location where the account string 
is to be stored. (If the byte size exceeds eight 
bits, bytes are truncated to eight bits.) 

The monitor call return with an updated pointer in 
AC3 and the source task's account number stored as 
specified. If no account string was supplied by 
the source task, AC3 continues to point to the 
beginning of the string, and a null is returned as 
the only character. 

.MORDA Return the optional data supplied in any of the 
connect or disconnect messages. This function 
requires that AC3 contain a string pointer to the 
location where the optional user data is to be 
stored. (This file is binary; the string pointer 
should specify 8-bit bytes.) 

The monitor call returns with an updated pointer 
in AC3 and the optional data stored as specified. 
AC4 contains the number of bytes in the data 
string; a zero value indicates that no optional 
data was supplied. 
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. MORCN 



35 



.MORIM 



36 



.MOSIM 



37 



. MOROD 
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Meaning 

Return the object type that was used by the source 
task to address this connection. The result 
indicates whether the local task was addressed by 
its generic type or its unique network task name. 

The monitor call returns with the object type in 
AC3. A zero object type indicates that the target 
task was addressed by its unique network task 
name; a nonzero value indicates that it was 
addressed by its generic object type. 

Read interrupt message. This function requires 
that AC3 contain a byte pointer to the receiving 
buffer. (If the byte size exceeds eight bits, 
bytes are truncated to eight bits.) The maximum 
message length is 16 bytes, and the buffer size 
should be at least 8 bits. 

The monitor call returns with an updated pointer 
in AC3, the message stored in the buffer, and the 
count of bytes received in AC4. 

Send an interrupt message. This function requires 
that AC3 contain a byte pointer to the message 
(eight bytes maximum) and that AC4 contain a count 
of the bytes in the interrupt message (sixteen 
bytes maximum) . 



Return the unique 
task. This iden 
object-descriptor , 
DECnet implementa 
addition, if the 
system that prov 
this information i 
task name is on 
returned is TASK-t 
that AC3 contain 
where the object-d 
to be stored, 
bits, bytes are tr 



identification of the source 
tification is in the format of 

and the contents depend on the 
tion on the remote host. In 
source task is running on a 
ides for group and user codes, 
s also returned. If the source 
a DECnet-20 host, the data 
askname. This function requires 
a string pointer to the location 
escriptor of the source task is 
(If the byte size exceeds eight 
uncated to eight bits.) 



The monitor call returns with an updated pointer 
in AC3 and the object-descriptor stored as 
specified. In addition, if the source host system 
uses group and user codes (sometimes referred to 
as project and programmer number or p,pn), AC4 
contains the group code in the left half and the 
user code in the right half. If the source host 
system does not provide for group or user codes, 
AC4 contains zeros. 
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40 .MOCLZ Reject a connection either implicitly or 

explicitly. If the target task closes its JFN 
(via the CLOSF monitor call) before accepting the 
connection either implicitly or explicitly, the 
local NSP assumes that the connection is rejected 
and sends a connect reject message back to the 
source task. The reason given is process aborted 
(reject code 38, .DCX38) . The target task must 
then reopen its JFN in order to receive subsequent 
connect initiate messages. In order to explicitly 
reject a connect and at the same time return a 
specific reject reason and set up 16 bytes of user 
data, the target task must use the .MOCLZ function 
of the MTOPR monitor call. The .MOLCZ function 
does not close the JFN. 

This function requires that 

AC2 contain a reject code in the left half 
and .MOCLZ in the right half. The reject 
code is a 2-byte, NSP-defined decimal number 
indicating the reason that a target task is 
rejecting a connection. Refer to the 
description of code 25, .MORLS, for a list of 
disconnect/reject codes. 

AC3 contain a string pointer to any data to 
be returned. (If the byte size exceeds eight 
bits, bytes are truncated to eight bits.) 

&C4 contain the count of bytes in the data 
string (maximum=16) . A zero indicates no 
data. 

41 .MOCC Accept a connection either implicitly or 

explicitly. Under certain conditions, the local 
NSP assumes that the connection is accepted and 
sends a connect confirm message back to the source 
task. These implicit conditions are 

The target task attempts to output to the 
logical link (issues a SOUT or SOUTR monitor 
call to the network) . 

The target task submits a read request to the 
logical link (issues a SIN or SINR monitor 
call to the network) . 

The target task is in input wait state (has 
enabled itself for a "data available" 
software interrupt) . 

In order to explicitly accept a connect and also 
return a limited amount of data, the target task 
must use the .MOCC function of the MTOPR monitor 
call. This function requires that AC3 contain a 
string pointer to any data to be returned. (If 
byte size exceeds eight bits, bytes are truncated 
to eight bits.) AC4 must contain the count of 
bytes in the data string to a maximum of 16 bytes. 
A zero indicates no data. 
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Code 
42 



43 



Symbol Meaning 

.MORSS Returns the maximum segment size that can be sent 
over this link. This value is the minimum of the 
maximum segment size supported by the remote NSP 
task, the segment size supported by the remote 
network task, and the segment size supported by 
the local NSP task. The local task can use this 
value to optimize the format of data being 
transmitted over the link. 

The monitor call returns the maximum segment size, 
in bytes, in AC3. 

. MOANT Attach network terminal. This function passes a 
DECnet logical link from the DECnet backround job 
(MCBNRT) to TOPS-20 so that TOPS-20 can control 
terminal I/O to and from the DECnet logical link. 
The MCBNRT program must establish the logical link 
and exchange the necessary DECnet protocols before 
this function of the MTOPR call is executed. 



44 



MOSNH 



The JFN accepted by this function in AC1 
JFN of the DECnet logical link. 



is 



the 



This call returns the line number 
logical link in AC2. 



of the DECnet 



The TOPS-20 job is associated with the DECnet 
logical link until one of the following occurs: 

1. The logical link is broken by the foreign host 
or by DECnet. 

2. The job logs out, more data comes through the 
logical link, and the first character of that 
data is not a CTRL/C . If the first character 
is a CTRL/C, a new job is created using the 
same logical link. 

Sets the network host. This function causes the 
terminal specified in the argument block to send 
data to and receive data from the DECnet logical 
link. The link connects the terminal on the local 
host to a job on a foreign host. The DECnet 
logical link to the foreign host must be 
established by the user process before this MTOPR 
function can be executed. 

This function requires the JFN of the logical link 
in AC1 , and the address of the argument block in 
AC3. The argument block has the following format: 

Word Symbol Contents 

The length of the argument block 
including this word. 

1 .SHTTY Identifier of the terminal that is 

controlling the local job. 

2 .SHESC Flags in the left half, ASCII 

escape character in the right half. 
The flags defined are: 



SH%LPM local page mode 
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Front-End Functions 



Code 
3 



Symbol 
.MOEOF 



. MODTE 



Meaning 

Causes TOPS-20 to flush its buffers and send all 
data to the front end. Optionally, it will notify 
the front end of the end-of-file condition. If 
AC3 is zero, the buffers are flushed and the end 
of file status is sent to the front end. If AC3 
is non-zero, only the buffers are flushed. 

This function is used for synchronization between 
a program running on TOPS-20 and a program running 
on the front end. 

Assign the specified device to the DTE controller 
on the front end. This function, which must be 
performed before I/O is allowed to the device, 
requires AC3 to contain the device type. The 
process must have WHEEL or OPERATOR capability 
enabled. 

Unless otherwise noted, the JFN must be opened 
before the MTOPR function can be performed. 



MTA/MT Functions 



Code 


Symbol 





.MOCLE 


1 


. MOREW 



The functions available for physical magnetic tape drives (MTA) and 
logical magnetic tape drives (MT) are described below. Some of these 
functions accept arguments in AC3 (refer to the individual 
descriptions). In the following descriptions, a labeled tape is one 
acquired via a MOUNT command and has one of the following attributes: 
ANSI, TOPS20, or EBCDIC. 

Meaning 

Clear any error flags from a previous MTOPR call. 

Rewind the tape. This function waits for activity 
to stop before winding the tape. If sequential 
data is being output, the last partial buffer is 
written before the tape is rewound. Control 
returns to caller when rewinding begins. For 
labeled tapes, this function causes the first 
volume in the set to be mounted and positioned to 
the first file in the file set. Since a volume 
switch may be required, this function could block 
for a considerable amount of time. 

Use function .MORVL to rewind the current volume. 

MOSDR Set the direction of the tape motions for read 
operations. This function requires AC3 to contain 
the desired direction. If AC3 = 0, the tape 
motion is forwards; if AC3 = 1, the tape motion 
is backwards. 

This function is not available for labeled tapes 
and will return an MTOX1 error if used for that 
purpose . 
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Code 
3 



Symbol 
.MOEOF 



.MOSDM 



.MOSRS 



Meaning 

Write a tape mark. This function requires that 
the magnetic tape be opened for write access. If 
sequential data is being output, the last partial 
buffer is written before the tape mark. 

For labeled tapes, issuing this function will 
terminate the data portion of the file, write EOF 
trailer labels and leave the tape positioned to 
accept user trailer labels. It is possible at 
this point to write user trailer labels or close 
the file. A second .MOEOF function issued without 
positioning the tape backwards will "close" the 
file (subsequent writes will create a new file). 

Set the hardware data mode to be used when 

transferring data to and from the tape. This 

function requires AC3 to contain the desired data 
mode : 



SJDDM default system data mode 
SJDMC dump mode (36-bit bytes) 
SJDM6 SIXBIT byte mode for 7-track drives 
SJDMA ANSI ASCII mode (7 bits in 8-bit 
bytes) 

SJDM8 industry compatible mode 

SJDMH High-density mode for TU70 and TU72 

tape drives only (nine 8-bit bytes 

in two words) . 



For labeled tapes, this function is allowed only 
if the file is opened in dump mode (.GSDMP). If 
this is not the case, an MTOX1 error is returned. 

Set the size of the records. This function 
requires AC3 to contain the desired number of 
bytes in the records. This function is allowed 
only if no I/O has been done since the JFN was 
opened . 

For labeled tapes, this function is allowed only 
if the file has been opened in dump mode. If the 
file has not been opened in dump mode, an MTOX1 
error is returned. 



The maximum size of the records (in bytes) 
follows : 



is 



as 



Hardware 
I/O Mode 

system-default 

dump 

(dump is usual default) 

SIXBIT 

ANSI ASCII 

industry compatible 

high density 



Maximum 

Pecord Size (bytes) 



8192 



49152 
40960 
32768 
8192 



The above values can be exceeded in the execution 
of .MOSRS; however, the first data transfer will 
fail. 
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Code 
6 



10 



11 



12 



13 



Symbol Meaning 

. MOFWR Advance over one record in the direction away from 
the beginning of the tape. If sequential data is 
being read in the forward direction and not all of 
the record has been read, this function advances 
to the start of the next record. If sequential 
data is being read in the reverse direction and 
not all of the record has been read, this function 
positions the tape at the end of that record. 

For labeled tapes, forward space will position 
over a logical record. This implies that many 
physical records may be skipped (if S format is 
used) perhaps involving one or more volume 
switches. 

.MOBKR Space backward over one record in the direction 
toward the beginning of the tape. If sequential 
data is being read in the forward direction and 
not all of the record has been read, this function 
positions the tape back to the start of that 
record. If sequential data is being read in the 
reverse direction and not all of the record has 
been read, this function positions the tape to the 
end of the record physically preceding that 
record . 

For labeled tapes, backward spacing will position 
over a logical record. This implies that many 
physical records may be skipped (if S format is 
used) perhaps involving one or more volume 
switches. 

. MOEOT For unlabeled tapes, advance forward until two 
sequential tape marks are seen and position tape 
after the first tape mark. 

For labeled tapes, this function will position the 
volume set beyond the end of the last file in the 
set. This is useful for adding a new file to the 
end of an already existing volume set. This 
function may take some time to complete as one or 
more volumes switches may be required. 

.MORUL Rewind and unload the tape. This function is 
identical to the . MOREW function and also unloads 
the tape if the hardware supports tape unloading. 

This function is illegal for any tape acquired via 
the MOUNT command. 

. MORDN Return the current density setting. On a 
successful return, AC3 contains the current 
density. 

.MOERS Erase three inches of tape (i.e., erase gap). 
This function requires that the magnetic tape be 
opened for write access. 

This function is illegal for labeled tapes. 
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Code 
14 

15 
16 



17 



Symbol Meaning 

.MORDM Return the hardware data mode currently being used 
in transfers to and from the tape. On a 
successful return, AC3 contains the current data 
mode. 

. MORRS Return the size of the records. On a successful 
return, AC3 contains the number of bytes in the 
records . 

.MOFWF Advance to the start of the next file. This 
function advances the tape in the direction away 
from the beginning of the tape until it passes 
over a tape mark. 

For labeled tapes, forward space will skip one 
logical file. This implies that many physical 
files may be skipped, involving perhaps one or 
more volume switches. 

.MOBKF Space backward over one file. This function moves 
the tape in the direction toward the beginning of 
the tape until it passes over a tape mark or 
reaches the beginning of the tape, whichever 
occurs first. 

For labeled tapes, backspace file will back up one 
logical file. This implies that many physical 
files may be skipped, involving perhaps one or 
more volume switches. 



NOTE 

For labeled ANSI tape, the monitor can 
compute the number of volume switches 
required to get to the first section of 
the file. Thus, if this function is 
issued for an ANSI tape, at most one 
volume switch will be required. This is 
not true for EBCDIC tapes. 



20 



.MOSPR 



21 



22 



MORPR 



.MONRB 



Issuing this function when the tape is already 
positioned at the first volume of the volume set 
will not produce an error. The program issuing 
this function must follow the .MOBKF with a GDSTS 
call to determine if the BOT was encountered 
during the backspacing operation. 



Set the parity. This function 
contain the desired parity: 



requires AC3 to 



.SJPRO 

1 .SJPRE 



odd parity 
even parity 



Return the current parity. On a. successful 
return, AC3 contains the current parity. 

Return number of bytes remaining in the current 
record. On a successful return, AC3 contains the 
number of bytes remaining. This function is only 
meaningful during sequential I/O. 
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Code 
23 

24 



Symbol 
.MOFOU 

.MOSDN 



25 



.MOINF 



26 



MORDR 



27 



.MOSID 



Meaning 

Force any partial records to be written during 
sequential output. 

Set the density. The function requires AC3 to 
contain the desired density. 

. SJDDN default system density 

1 .SJDN2 200 BPI (8 rows/mm) 

2 .SJDN5 556 BPI (22 rows/mm) 

3 .SJDN8 800 BPI (31 rows/mm) 

4 .SJD16 1600 BPI (63 rows/mm) 

5 .SJD62 6250 BPI (246 rows/mm) 

This function is illegal for labeled tapes. 

Return information about the tape. This function 
requires AC3 to contain the address of the 
argument block in which the information is to be 
returned. The format of the argument block is as 
follows: 



Word Symbol 
. MOICT 



Contents 

Length of argument block to be 

returned (not including this word) 

MTA type code 

MTA reel ID 

Channel, controller, and unit in 

the left half and serial number in 

the right half. 

Number of reads done 

Number of writes done 

Record number from beginning of 

tape 

Number of files on tape 
Number of soft read errors 
Number of soft write errors 
Number of hard read errors 
Number of hard write errors 
Number of frames read 
Number of frames written 



The JFN need not be open for this function. 

Return the direction that the tape is moving 
during read operations. On a successful return, 
AC3 = if the direction of the tape motion is 
forwards, or AC3 = 1 if the direction of the tape 
motion is backwards. 

Set the reel identification of the tape mounted. 
The process must have WHEEL or OPERATOR capability 
enabled. This function requires AC3 to contain 
the desired 36-bit reel ID. The JFN need not be 
open for this function. 



1 


.MOITP 


2 


.MOIID 


3 


.MOISN 


4 


.MOIRD 


5 


.. MOIWT 


6 


.MO IRC 


7 


.MOIFC 


10 


,. MOISR 


11 


.MOISW 


12 


.MOIHR 


13 


.MOIHW 


14 


.MOIRF 


15 


. MOIWF 
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Code 
30 



Symbol 
.MOIEL 



31 
32 



. MONOP 
. MOLOC 



37 



.MOSTA 



Meaning 

Inhibit error logging for the tape. If AC3 is 
non-zero, error logging will be inhibited on 
subsequent operations on the tape drive. If AC3 
is zero, error logging will be performed. The 
setting remains in effect until the JFN is closed. 
Error logging occurs by default if no setting is 
made with function .MOIEL. 

Wait for all activity to stop. 

Specifies the first volume in a MOUNT request, or 
identifies the "next" volume for a volume switch. 
This function requires OPERATOR or WHEEL 
capability. 

AC3 contains a pointer to an argument block having 
the following format: 



Word Symbol 






. MOCNT 


1 


. MOMTN 


2 


.MOLBT 


3 


. MODNS 


4 


. MOAVL 


5 


. MONVL 


6 


.MOCVN 


7 


. MOVSN 



Contents 

count of words in the block 

MT unit number to associate with 

this MTA 

label type (.LTxxx) 

density 

address of volume labels 

number of volume labels at .MOAVL 

volume number in the volume set 

SIXBIT file set identifier 



The JFN need not be open for this function. 

Return current magtape status. Returns 
argument block having the following form 
contents: 



an 
and 



Word 


Symbol 




Contents 





.MOCNT 


Count of words 
this word 


in the b 


1 


. MODDN 


density flags 








Bl SJ%CP2 


200 BPI 






B2 SJ%CP5 


556 BPI 






B3 SJ%CP8 


800 BPI 






B4 SJ%C16 


1600 BPI 






B5 SJ%C62 


6250 BPI 


Word 


Symbol 


Contents 




2 


.MODDM 


data mode flag 


s 



Bl 


SJ%CMC 


core d ump 


B2 


SJ%CM6 


SIXBIT 


B3 


SJ%CMA 


ANSI ASCII 


B4 


SJ%CM8 


industry compatible 


B5 


SJ%CMH 


high density mode 
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Symbol 
. MOTRK 



.MOCST 



Contents 

recording track flags 

Bit Symbol Meaning 

Bl SJ%7TR 7-track drive 

B2 SJ%9TR 9-track drive 

tape status flags 

Bit Symbol Meaning 



BO 


SJ%OFS 


off line 


Bl 


SJ%MAI 


maintenance mode 
enabled 


B2 


SJ%MRQ 


maintenance mode 
requested 


B3 


SJ%BOT 


beginning of tape 


B4 


SJ%REW 


rewinding 


B5 


SJ%WLK 


write locked 



. MODVT 



device type 



Coc 


le 


Symbol 


Meaning 


3 




.MTT4 5 


TU45 (system default 


17 




.MTT7 


TU70 


20 




.MTT71 


TU71 


21 




.MTT7 2 


TU72 


13 




.MTT7 7 


TU77 


19 




.MTT78 


TU78 



The JFN need not be open for this function. 



Enable interrupts 
Allows a process 
tape drive's state 
or vice-versa 
completes. This f 
for each drive 
enabled. If mul 
interrupts, then 
performed (for eac 
the drives are e 
occurs, .MOSTA can 
the current stat 
against the previo 
determined which d 



for online/offline 
to be interrupted if 
changes from online 
and when a rewind 
unction must be perf 
for which interrupt 
tiple drives are e 

a .MOSTA function 
h drive) before inte 
nabled. Then, when a 
be performed for eac 
us of that drive can 
us status. Thus, 
rive (or drives) inte 



transition. 

a magnetic 
to offline 
operation 
ormed once 
s are to be 
nabled for 

should be 
rrupts for 
n interrupt 
h drive and 
be compared 
it can be 
r rupted . 



This function rquires OPERATOR or WHEEL 
capability. The JFN need not be open for this 
function. 
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Code 
42 



43 



44 



Symbol Meaning 

.MOPST Declares the software interrupt channel to be used 
by the monitor to indicate that the UTL labels at 
the end-of-volume or the UHL labels at the start 
of the new volume are available. If this MTOPR is 
not performed before an EOV label set is 
encountered, the user program will not be given 
the opportunity to process the UTL or UHL labels 
during the volume switch operation. 

AC3 contains the PSI channel number to set. The 
channel can be cleared by using -1 in AC3. 

This function is for labeled tapes only. 

.MORVL Rewind current labeled tape volume. This function 
is for labeled tapes only. 

.MOVLS Switch volumes for an unlabeled multi-volume set. 
If an unlabeled tape is mounted specifying 
multiple volumes in the volume set, the monitor 
will not automatically perform a volume switch at 
the end of each volume. The .MOVLS function may 
be issued in such a case to perform a volume 
switch. This function is legal only for unlabeled 
MT devices. 

AC3 contains the address of an argument block 
having the following format: 

Word Symbol Contents 

- count of words in block including 

this word 

1 - f lags ,, function code 

2 - argument (if required) 

Available functions are: 
Word Symbol Function 



.VSMNV 



2 


.VSFST 


3 


.VSLST 


4 


.VSMRV 



mount 
volume 



absolute 
number 



(volume number in 
word 2 of the 
argument block) 
mount first volume 
in set 

mount last volume 
in set 

mount relative 
volume number 
(volume number in 
word 2 of the 
argument block) 
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44 



MOVLS (Cont.) 



Word Symbol Function 



.VSMRV For .VSMRV, the 
(Cont.) argument in word 2 
of the argument 
block is the volume 
number relative to 
the current mounted 
volume to mount. 
For example, if 
volume 2 is 
currently mounted 
and .VSMRV is 
performed with 2 in 
word 2 of the 
argument block, 
then volume 4 will 
be mounted. 
Specifying 1 in 
word 2 of the 
argument block will 
mount the next 
volume in the set. 
.VSFLS force volume switch 
for labeled tape. 
This function is 
only for tapes for 
which .MOSDS has 
previously been 
set. 



45 



MONTR 



Set no translate. 



Sets or clears the EBCDIC to ASCII translate flag. 
If the flag is set and the tape file being read is 
from an IBM EBCDIC volume, then all data delivered 
to the user program will be in its original EBCDIC 
form. If the flag is not set, and the file is 
from an IBM EBCDIC volume, then all data delivered 
to the user program will be in ASCII. In order to 
perform this translation, certain information may 
be lost (as the EBCDIC character set contains 256 
codes while the ASCII character set contains only 
128 codes - see Appendix A for ASCII-to-EBCDIC 
conversions) . Note that the setting of this flag 
has no effect on the data delivered by the MTU% 
JSYS. This setting applies until explicitly 
changed or until the MT is dismounted. The 
default value of the flag is "clear" (translate). 

If AC3 is zero, the translate flag is cleared. If 
AC3 is non-zero, the translate flag is set. 

This function is for labeled tapes only. 
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Code 
46 



Symbol 
.MORDL 



47 



.MOWUL 



Meaning 

Read user header labels. Labels must be read 
immediately after the file is opened (and before 
the first input is requested) or after a volume 
switch has occurred and the volume switch PSI has 
been generated. .MORDL may be used to read either 
the UHL or UTL labels. User header labels may be 
read only if the file is opened for read or 
append. The labels may be a maximum of 76 
characters long. 

User trailer labels may be read at any time. If 
the program requests to read user trailer labels, 
the tape will be positioned to the EOF trailer 
section. 



AC3 contains a byte pointer to 
receiving the label. 



the area for 



On a successful return, AC2 contains the user 

label identifier. This will be the ASCII 

character following the UHL or the UTL. AC3 will 
contain an updated byte pointer. 

This function is for labeled tapes only. 

Write user header labels or user trailer labels. 
User header labels may be written only after the 
file is opened (and before the first write is 
performed) or when a PSI is generated, indicating 
that a volume switch has occurred. User header 
labels may be written only if the file is opened 
for write access. 

User trailer labels may be read or written at any 
time. If the program requests to write user 
trailer labels, the file will be terminated with 
an EOF trailer section. Once user trailer labels 
are written in this manner, no more data may be 
read or written. 

User trailer labels may also be written during a 
volume switch sequence. Once the PSI indicating 
EOV has been received, the user program may write 
a UTL label into the EOV trailer section. This 
operation must be performed at interrupt level. 

AC3 contains a byte pointer to the label contents. 
This string must contain 76 bytes of data (the 
monitor will use only the first 76 bytes) . AC4 
contains a label identifier code (any ASCII 
character) . 

It is possible to encounter EOT while writing the 
first UTL in the EOF trailer set. This can occur 
if the last data write overwrote the EOT mark. In 
this instance, the user program will receive the 
EOV PSI from within the code writing the UTL 
labels for the file. It is not possible to 
receive an EOV PSI while writing the trailer 
labels in the EOV set. 
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Code Symbol Meaning 

This function is for labeled tapes only. 

50 .MORLI Reads the available fields from the standard 

volume and header labels. 

AC3 contains a pointer to an argument block of the 
form: 



Word 


1 



2 

3 

4 

5 
6 
7 

10 

11 

12 
13 
14 



Contents 

count of words in block 

word to store label type of this tape 

Value Symbol Label Type 



1 
2 
3 
4 

byte po 
name st 
byte po 
name st 
word t 
charact 
word to 
word to 
word to 
format) 
word t 
interna 
word if 
byte po 
name st 
word to 
word to 
word to 
value) . 
follows 

Mode 
Value 

space 

A 

M 

X 



.LTUNL 
.LTANS 
.LTEBC 
.LTT20 



Unlabeled 
ANSI 
EBCDIC 
TOPS-20 



inter to area for storing volume 

ring 

inter to area for storing owner 

ring 

o store tape format (ASCII 

er) 

store record length 

store block length 

store creation date (in internal 

store expiration date (in 

1 format) . Returns a -1 in this 
the date is invalid. 

inter to area for storing file 
ring 

store generation number 

store version number 

store mode value (form-control 
The possible modes are as 



Meaning 

no line format characters are 

present 

FORTRAN format control 

characters are present 

All necessary line format 

characters are present 

Data in stream mode 



The user specifies only the block count and the 
byte pointers; the remaining values are returned 
by the monitor. If a zero is substituted for any 
of the byte pointers, then the associated string 
is not returned. 
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Code 


Symbol 


50 


.MORLI 




(Cont. ) 



51 



MOSMV 



52 



.MOSDS 



PLPT Functions 
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Meaning 

This function is normally issued when the JFN is 
open. If issued when the JFN is closed, only the 
first 3 words of the argument block are returned. 
If the tape is unlabeled, only the first word of 
the argument block is returned. For labeled tapes 
only . 

Declares the value to be placed in the DEC-defined 
"form-control" field in the HDR2 label. This 
field is not defined in the ANSI standard but 
should be specified whenever the data file is 
meant to be read with DEC-supplied software. This 
function merely declares the value to be placed in 
the label. It is the user program's 
responsibility to produce records that conform to 
the declared mode. 

AC3 contains one of the following modes: 



Value 



Symbol 





1 


.TPFST 
.TPFCP 


2 
3 


.TPFFC 
.TPFNC 



Mode 

X - (stream mode) 

M - (all formatting control 

present) 

A - (FORTRAN control present) 

space - (no controls present) 



This function is for labeled tapes only. 

Set deferred volume switch. Inhibits the monitor 
from doing an automatic volume switch and allows a 
program to write its own trailer information 
beyond the physical end-of-tape mark. This 
function is intended for labeled MT devices open 
for writing in DUMP mode. 



The functions available for physical line printers (PLPT) are 
described below. Some of these functions accept the address of an 
argument block in AC3. The first word of the argument block contains 
the length (including this word) of the block. Remaining words of the 
block contain arguments for the particular function. 

Code Symbol Meaning 

27 .MOPSI Enable for a software interrupt on nonfatal device 

conditions. Examples of these conditions are: 

1. Device changed from offline to online. 

2. Device changed from online to offline. 

3. Device's page counter has overflowed. 

Other device errors or software conditions are not 
handled by this function; instead they cause a 
software interrupt on channel 11 (.ICDAE). 
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Code 
27 



Symbol 

.MOPS I 
(Cont. ) 



Meaning 



31 



. MONOP 



32 



.MOLVF 



33 



.MORVF 



34 



MOLTR 



35 



.MORTR 



Argument Block 



E: 

E+l 

E+2 



interrupt channel number 

flags. The following flag is defined: 

B0(MO%MSG) Suppress standard CTY device 
messages. 

Wait for all activity to stop. This function 
blocks the process until all data has actually 
been sent to the printer and has been printed. 
Because this function is transferring data, it can 
return an IOX5 data error. 

Load the line printer's VFU (Vertical Formatting 
Unit) from the file indicated in the argument 
block . 

Argument Block 

E: 2 

E+l: JFN of the file containing the VFU 

The system opens the. file for input with a byte 
size of 18 bits. It closes the file and releases 
the JFN when the loading of the VFU is complete. 

Read the name of the current VFU file stored in 
the monitor's data base. 

Argument Block 

E: 3 

E+l: pointer to destination area for ASCIZ name 

str ing 
E+2: number of bytes in destination area 

Load the line printer's translation RAM (Random 
Access Memory) from the file indicated in the 
argument block. 

Argument Block 

E: 2 

E+l: JFN of the file containing the translation 
RAM 

The system opens the file for input with a byte 
size of 18 bits. It closes the file and releases 
the JFN when the loading of the translation RAM is 
complete . 

Read the name of the current translation RAM file 
stored in the monitor's data base. 

Argument Block 

E: 3 

E+l: pointer to destination area for ASCIZ name 

s t r i ng 
E+2: number of bytes in destination area 
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36 .MOSTS Set the status of the line printer. 

Argument Block 

E: 3 

E+l: software status word, with the following 
status bits settable by the caller: 

36 .MOSTS B0(MO%LCP) Set line printer as a lowercase 

printer . 

B12(MO%EOF) Set bit MO%EOF in the printer 
status word when all data sent 
to printer has actually been 
printed. The status word can 
be obtained with the . MORST 
function. 

B14(M0%SER) Clear the software error 
condition on the line printer. 
This condition usually occurs 
on a character interrupt. 

Other status bits can be read with the 
.MORST function (see below) but cannot be 
set by the caller. 

E+2: value for page counter register. The caller 
can indicate the number of pages to be 
printed by specifying a value of up to 12 
bits (4096) . Each time the printer reaches 
the top of a new page, it decrements the 
value by one. When the value becomes zero, 
the printer sets status bit MO%LPC and 
generates an interrupt if the .MOPSI 
function was given previously. 

If the caller specifies a value of in the 
register, the system will maintain the page 
counter and will not generate an interrupt 
to the caller when the page counter becomes 
zero. 

If the caller specifies a value of -1 in the 
register, the value will be ignored. 

37 .MORST Read the status of the line printer. The status 

is obtained from the front end, and the caller is 
blocked until it receives the status. 

Argument Block 

The following bits are 

BO (MO%LCP) Line printer is a lower case 
printer. This bit is set only 
if a .MOSTS function declaring 
the printer lower case was 
executed previously. 
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3 


E + l: 


status word. 




defined : 
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Code Symbol Meaning 

37 .MORST Bl(MO%RLD) Front end has been reloaded. 

(Cont.) This bit is reset to zero the 

next time any I/O activity 
begins for the line printer. 

BIO (MO%FER) A fatal hardware error 
occurred. This condition 
generates a software interrupt 
on channel 11 (.ICDAE). 

B12(MO%EOF) All data sent to printer has 
actually been printed. 

B13(MO%IOP) Output to the line printer is 
in progress. 

B14(MO%SER) A software error (e.g., 
interrupt character, page 
counter overflow) occurred. 

B15(MO%HE) A hardware error occurred. 
This error generates a software 
interrupt on channel 11 
(.ICDAE). This condition 
usually requires that the forms 
be realigned. 

B16(MO%OL) Line printer is offline. This 
bit is set on the occurrence of 
any hardware condition that 
requires operator intervention. 

B17(MO%FNX) Line printer does not exist. 

B30 (MO%RPE) A RAM parity error occurred. 

B31(MO%LVU) The line printer has an optical 
(12-channel tape reader) VFU. 

B33(MO%LVF) A VFU error occurred. The 
paper has to be realigned. 

B34(MO%LCI) A character interrupt occurred. 
This generates a software 
interrupt on channel 11 
(.ICDAE) . 

B35(MO%LPC) The page counter register has 
overflowed . 

Bits 2-17 contain the software status word 
from the front end, and bits 20-35 contain 
the hardware status word. 

E+2: value of page counter register. A value of 
-1 indicates the printer has no page counter 
value defined. 

40 .MOFLO Flush any line printer output that has not yet 

been printed. 
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PCDP Functions 



The functions available for physical card punches (PCDP) are described 
below. Like the PLPT functions, these functions accept the address of 
an argument block in AC3. The first word of the block contains the 
length (including this word) of the block. Remaining words in the 
block contain arguments for the particular function. 

Code Symbol Meaning 

27 .MOPSI Enable for a software interrupt on nonfatal device 

conditions. Examples of these conditions are: 

1. Device changed from offline to online. 

2. Device changed from online to offline. 

Other device errors or software conditions are not 
handled by this function; instead they cause a 
software interrupt on channel 11 (.ICDAE). 

Argument Block 

E: 3 

E+l: interrupt channel number 

E+2: flags. The following flag is defined: 

B0(MO%MSG) Suppress standard CTY device 
messages . 

37 .MORST Read the status of the card punch. The status is 

obtained from the front end, and the caller is 
blocked until it receives the status. 

Argument Block 

E: 2 

E+l: status word. Bits 2-17 contain the software 

status word from the front end, and bits 

20-35 contain the hardware status word. 

B10(MO%FER) Fatal error condition 

B12(MO%EOF) All pending output has been 
processed 

B13(MO%IOP) Output in progress 

B14(MO%SER) Software error has occurred 
(would generate an interrupt on 
an assigned channel) 

B15(MO%HE) Hardware error has occurred 
(would generate interrupt on 
channel .ICDAE) 

B16(MO%OL) Card punch is offline. This 
bit is set when operator 
intervention is required (card 
jam, hopper empty, or stacker 
full) . 

B17(M0%FNX) Card punch doesn't exist 

B32(MO%HEM) Hopper is empty or stacker is 
full 

B33(MO%SCK) Stack check 

B34(MO%PCK) Pick check 

B35(MO%RCK) Read check 
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PCDR Functions 



The functions available for physical card readers (PCDR) are described 
below. These functions accept the address of an argument block in 
AC3. The first word of the block contains the length (including this 
word) of the block. Remaining words in the block contain arguments 
for the particular function. 



Code 
27 



37 



Symbol Meaning 

.MOPSI Enable for a software interrupt on nonfatal device 
conditions. Examples of these conditions are: 

1. Device changed from offline to online. 

2. Device changed from online to offline. 

Other device errors or software conditions are not 
handled by this function; instead they cause a 
software interrupt on channel 11 (.ICDAE). 

Argument Block 

E: 3 

E+l : interrupt channel number 

E+2: flags. The following flag is defined: 

B0(MO%MSG) Suppress standard CTY device 
messages . 

.MORST Read the status of the card reader. The status is 
obtained from the front end, and the caller is 
blocked until it receives the status. 

Argument Block 

E: 2 

E+l: status word. Bits 2-17 contain the software 
status word from the front end, and bits 
20-35 contain the hardware status word. 



BO (MO%COL) 



Bl (MO%RLD) 



10 (MO%FER) 



Card reader is on line. This 
bit is not obtained from the 
front end. 

Front end has been reloaded. 
This bit is reset to zero the 
next time I/O activity begins 
for the card reader. 

A fatal hardware error 
occurred. This condition 
generates a software interrupt 
on channel 11 (.ICDAE). 



B12(M0%E0F) Card reader is at end of file. 

B13 (MO%IOP) Input from the card reader is 
in progress . 

B14(M0%SER) A software error (e.g., 
interrupt character) occurred. 
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Code 
37 



Symbol 

.MORST 
(Cont.) 



Meaning 

B15(MO%HE) A fatal hardware error 
occurred. This error generates 
a software interrupt on channel 
11 (.ICDAE). 

B16(MO%OL) Card reader is off line. This 
bit is set on the occurrence of 
any hardware condition that 
requires operator intervention. 

B17(M0%FNX) Card reader does not exist. 

B31(M0%SFL) The output stacker is full. 

B32(MO%HEM) The input hopper is empty. 

B33(MO%SCK) A card did not stack correctly 
in the output stacker. 

B34(MO%PCK) The card reader failed to pick 
a card correctly from the input 
hopper . 

B35(MO%RCK) The card reader detected a read 
error when reading a card. 



PTY Functions 



The functions available for pseudo-terminals (PTY) are described 
below. Some of these functions accept arguments in AC3. (Refer to 
the individual descriptions.) 



Code 
24 



25 



26 



Symbol Meaning 

.MOAPI Assign PTY interrupt channels. This function 
requires AC2 to contain 

B0(MO%WFI) enable waiting-f or- input interrupt 
Bl (MO%OIR) enable output-is-ready interrupt 
B12-B17(MO%SIC) software interrupt channel number 
for output to the PTY. The 
channel number used for input from 
the PTY is one greater than the 
channel number used for output to 
the PTY. 
B18-B35 function code 

.MOPIH Determine if PTY job needs input. On a successful 
return, AC2 contains O(.MONWI) if PTY job is not 
waiting for input or contains -l(.MOWFI) if PTY 
job is waiting for input. 

.MOBAT Set batch control bit. This function requires AC3 
to contain O(.MONCB) if the job is not to be 
controlled by batch or to contain l(.MOJCB) if the 
job is to be controlled by batch. To obtain this 
value, the process can execute the GETJI JSYS, 
function .JIBAT. 
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TTY Functions 
Code Symbol 
25 .MOPIH 



26 



.MOSPD 



27 



MORSP 



30 
31 
32 
33 
34 

35 



MORLW 



MOSLW 



MORLL 



MOSLL 



MOSNT 



MORNT 



Meaning 

Determine if TTY job needs input. On a successful 
return, AC2 contains O(.MONWI) if TTY job is not 
waiting for input or contains -l(.MOWFI) if TTY 
job is waiting for input. 



Set the terminal line speed, 
accepts in AC3 the desired line spe 
in the left half and output speed 
half) . The left half of AC2 con 
indicating the type of line be 
B0(MO%RMT) is on, the line is a r 
line. If Bl(MO%AUT) is on, the lin 
autobaud line (is automatically s 
and the contents of AC3 are ignored 
must have WHEEL or OPERATOR capabi 
set B0(MO%RMT) and Bl (MO%AUT) . In 
bits can only be set at start 
cannot be set during timesharing.) 



Return the terminal line speed. On a successful 
return, the left half of AC2 contains flag bits 
indicating the type of line, and AC3 contains the 
speed (input speed in the left half and output 
speed in the right half). If BO (MO%RMT) of AC2 is 
on, the line is a remote line, and if Bl(MO%AUT) 
is on, the line is a remote autobaud line. AC3 
contains the speed or contains -1 if the speed is 
unknown or is not applicable. 
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Return the terminal page width, 
return, AC3 contains the width. 



On 



successful 



Set the terminal page width. This function 
requires AC3 to contain the desired width. 



Return the terminal page length, 
return, AC3 contains the length. 



On a successful 



Set the terminal page length. This function 
requires AC3 to contain the desired length. 

Specify if terminal line given in AC1 is to 
receive system messages. This function requires 
AC3 to contain (.MOSMY) to allow messages or 1 
(.MOSMN) to suppress messages. 

Return a code indicating if terminal line given in 
AC1 is to receive system messages. On a 
successful return, AC3 contains (.MOSMY) if 
messages are being sent to this line or 1 (.MOSMN) 
if messages are being suppressed to this line. 
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Code 
36 



Symbol 
.MOSIG 



37 



40 



.MORBM 



.MOSBM 



41 



MORFW 



42 



43 



MOSFW 



MOXOF 



44 



.MORXO 



Meaning 

Specify if input on this terminal line is to be 
ignored when the line is inactive (i.e., is not 
assigned or opened). This function requires AC3 
to contain if characters on this line are are 
not to be ignored or 1 if characters on this line 
are to be ignored. When input is being ignored 
and characters are typed, no CTRL/G (bell) is 
sent, as is the normal case when characters are 
typed on an inactive line. 

Read the 128-character break mask. The argument 
block (filled in by monitor) is the same as for 
.MOSBM (below) . 

Set the 128-character break mask. 

Argument Block: 

E: 0,,4 

E+l-E+4: character mask. The leftmost 32 bits of 
each consecutive word correspond to the 
ASCII character set in ascending order. 
For example, 1B0 in word E+l (of the 
argument block) corresponds to ASCII code 
000 (null) , 1B1 in word E+l corresponds 
to ASCII code 001 (SOH) . Bits 32-35 of 
each word must be zero. 

Return the current value of the field width in 
AC3. Note that this may be less than the value 
last set by .MOSFW. If the field width is set to 
value X and two characters are read before the 
.MORFW is executed, the value returned will be 
X-2. A zero returned in AC3 indicates that no 
field width is now in effect. 



Set the field width to the value in AC3. A 
indicates that no field width is in effect. 



zero 



Enable/disable pause-at-end-of-page mode. This 
function controls the TOPS-20 feature that sends 
exactly n lines of data to the terminal and 
suspends data transmission (n is the terminal 
length parameter, set by function .MOSLL). The 
user may manually resume data transmission by 
typing ~Q. 

AC3 contains one of the following values: 

.MOOFF Disable pause-at-end-of-page mode 

1 . MOONX Enable pause-at-end-of-page mode 

Note that this feature operates independently of 
the pause-on-command mode implemented in the JFN 
mode word (see bit TT%PGM of the JFN mode word) . 

Read the end-of-page mode. This function returns, 
in AC3, a one if PAUSE ON END-OF-PAGE is set for 
the terminal, a zero otherwise. 
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Code Symbol Meaning 

45 .MOSLC Set the terminal's line counter to value in AC3. 

This counter is incremented by the monitor 
everytime a linefeed is output to the terminal. 
The monitor clears this counter only when a line 
becomes active. 



46 


.MORLC 


Read 
its 


47 


.MOSLM 


Set 

f unc 

coun 

line 

line 

is 

the 

the 

the 


50 


.MORLM 


Read 



the terminal's line counter and 
value in AC3. 

line maximum to the value in 
tion sets the maximum value 
ter seen so far. The monitor 

counter with the maximum e 
feed is typed, and if the line c 
larger, the monitor sets the li 
value of the line counter. When 

cursor up on screen terminals, 
line counter. 



return with 

AC3. This 
of the line 
compares the 
very time a 
ounter value 
ne maximum to 
TEXTI moves 
it decrements 



Read the current value of the 
return with its value in AC3. 



line maximum and 



51 



MOTPS 



52 



MOPCS 



Assign terminal interrupt channels. An interrupt 
will be generated if a character is input, or an 
output-buffer-empty condition occurs on output. 

AC3 contains the address of a two-word argument 
block. The first word of the block contains the 
number of words in the block (2) , and the second 
word of the block contains the following: output 
PSI channel ,, input PSI channel. All input or 
output PSI channels for the terminal are cleared 
by placing a -1 in the appropriate half, or both 
halves, of word 2 of the argument block. 

Set the pause and unpause characters for the 
terminal. This function requires that AC3 contain 
the pause character in the left half, and the 
unpause (continue-af ter-pause) character in the 
right half. The characters can be the same, but 
should not be CTRL/Q or CTRL/S. 

.MOPCR Read the terminal pause and unpause 
(continue-af ter-pause) characters. This function 
returns, in AC3, the pause character in the elft 
half, and the unpause character in the right half. 

Generates an illegal instruction interrupt on error conditions below. 

MTOPR ERROR MNEMONICS: 

ANTX01: No more network terminals available 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 



53 
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DESX5: File is not open 

DESX9 : Invalid operation for this device 

DEVX2: Device already assigned to another job 

IOX4: End of labels encountered 

10X5: Device or data error 

MT0X1: Invalid function 

MT0X2: Record size was not set before I/O was done 

MT0X3: Function not legal in dump mode 

MT0X4: Invalid record size 

MT0X5: Invalid hardware data mode for magnetic tape 

MT0X6: Invalid magnetic tape density 

MT0X7: WHEEL or OPERATOR capability required 

MT0X8: Argument block too long 

MT0X9: Output still pending 

MTOX10: VFU or RAM file cannot be OPENed 

MT0X11: Data too large for buffers 

MT0X12: Input error or not all data read 

MTOX13: Argument block too small 

MT0X14: Invalid software interrupt channel number 

MT0X15: Device does not have Direct Access (programmable) VFU 

MT0X16: VFU or Translation RAM file must be on disk 

MT0X17: Device is not on line 

MT0X18: Invalid software interrupt channel number 

MT0X19: Invalid terminal line width 

MTOX20: Invalid terminal line length 

TTYX01: Line is not active 
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Allows privileged programs to perform various utility functions for 
magnetic-tape MT: devices. This JSYS differs from the MTOPP JSYS in 
that the invoking program need not have a JFN on the MT nor need it 
even have access to the MT. It is used by MOUNTR to declare a volume 
switch error and by the access-control program (user supplied) to read 
file and volume labels. 



RESTRICTIONS: 

ACCEPTS IN AC1 

AC 2 

AC3 

RETURNS +1 



Requires enabled WHEEL or OPERATOR capabilities 

function code 

MT unit number 

address of argument block 

always 



The functions and associated argument blocks are as follows 



Code 
1 



Symbol 
. MTNNV 



.MTRAL 



Function 
Declare volume switch error 
Argument Block: 
Word Symbol 



Contents 





1 

2 


.MTCNT 
.MTCOD 
.MTPTR 


Read 


labels 


Argument Block: 


Word 


Symbol 



1 


.MTCNT 
.MTVLl 


2 


.MTVL2 


3 


.MTHDl 


4 


.MTHD2 



count of words in block 
error code to return to user 
byte pointer to operator response 



Contents 

count of words in block 

byte pointer to area to hold VOL1 

label 

byte pointer to area to hold VOL2 

label 

byte pointer to area to hold HDR1 

label 

byte pointer to area to hold HDR2 

label 



If any of the byte pointers is 
associated string is not returned. 



zero , 



the 



The label values are always returned without 
translation. For example, if the tape is an 
EBCDIC labeled tape, the returned data will be 
EBCDIC data. 
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3 .MTASI return assignment information 

Argument Block: 

Word Symbol Contents 

.MTCNT count of words in block 

1 .MTPHU returned MTA number associated 

with the MT. If there is no 
association, .MTNUL is returned. 

This function is used by MOUNTR to determine if 
there are any existing MT to MTA associations. 

4 .MTCVV Clear the volume ID for the specified MT unit. 

This request will fail if the MT is opened or if 
the volume belongs to a labeled volume set. 
Requires WHEEL or OPERATOR capabilities enabled. 
There is no argument block. 

MTU% ERROR MNEMONICS: 

ARGX04: Argument block too small 

ARGX05: Argument block too long 

CAPX1: WHEEL or OPERATOR capability required 

DESX1: Invalid source/destination designator 

DESX9: Invalid operation for this device 

10X8: Monitor internal error 

0PNX1: File is already open 

0PNX8: Device is not on line 
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MUTIL JSYS 512 

Performs various IPCF (Inter-Process Communication Facility) 
functions, such as enabling and disabling PIDs, assigning PIDs, and 
setting quotas. Refer to the TOPS-20 Monitor Calls User's Guide for 
an overview and description of the Inter-Process Communication 
Facility. 



RESTRICTIONS: 

ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



some functions require WHEEL, OPERATOR, or IPCF 
capability enabled 

length of argument block 

address of argument block 

failure, error code in AC1 

success. Responses from the requested function are 
returned in the argument block. 

The format of the argument block is as follows: 

Word Meaning 

Code of desired function. (See below.) 

1 through n Arguments for the desired function. The 
arguments, which depend on the function requested, 
begin in word 1 and are given in the order shown 
below. Responses from the requested function are 
returned in these words. 



The available functions, along with their arguments 
below. 



are described 



Code 
1 



Symbol Meaning 

.MUENB Enable the specified PID to receive packets. The 
PID must have been created by the caller's job. 
Also, if the calling process was not the creator 
of the PID, the no-access bit (IP%NOA) must be off 
in the IPCF packet descriptor block. 

Argument 

PID 

.MUDIS Disable the specified PID from receiving packets. 

The PID must have been created by the caller's 

job. Also, if the calling process was not the 

creator of the PID, the no-access bit (IP%NOA) 

must be off in the IPCF packet descriptor block. 

Argument 

PID 
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Code Symbol Meaning 

3 .MUGTI Return the PID associated with <SYSTEM>INFO. The 

PID is returned in word 2 of the argument block. 

Argument 

PID or job number 

4 .MUCPI Create a private copy of <SYSTEM>INFO for the 

specified job. The caller must have IPCF 
capability enabled. 

Arguments 

PID to be assigned to <SYSTEM>INFO 

PID or number of job creating private copy 

5 .MUDES Delete the specified PID. The caller must own the 

PID being deleted. 

Argument 
PID 

6 .MUCRE Creates a PID for the specified process or job. 

The flags that can be specified are B6(IP%JWP) to 
make the PID job wide and B7(IP%NOA) to prevent 
access to PID from other processes. The caller 
must have IPCF capability enabled if the job 
number given is not that of the caller. The PID 
created is returned in word 2 of the argument 
block. If a job number is specified, the created 
PID will belong to the top fork of the job. 

Argument 

f lags ,, process handle or job number 

7 .MUSSQ Set send and receive quotas for the specified PID. 

The caller must have IPCF capability enabled. The 
new send quota is given in B18-B26, and the new 
receive quota is given in B27-B35. The receive 
quota applies to the specified PID, but the send 
quota applies to the job to which that PID 
belongs . 

Arguments 

PID 

new quotas 

10 .MUCHO Change the job number associated with the 

specified PID. The caller must have WHEEL 
capability enabled. 

Arguments 

PID 

new job number or PID belonging to new job 
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Code Symbol Meaning 

11 .MUFOJ Return the job number associated with the 

specified PID. The job number is returned in word 
2 of the argument block. 

Argument 

PID 

12 .MUFJP Return all PIDs associated with the specified job. 

Two words are returned, starting in word 2 of the 
argument block, for each PID. The first word is 
the PID. The second word has B6(IP%JWP) set if 
the PID is job wide and B7(IP%NOA) set if the PID 
is not accessible by other processes. The list is 
terminated by a PID. 

Argument 

job number or PID belonging to that job 

13 .MUFSQ Return the send and receive quotas for the 

specified PID. The quotas are returned in word 2 
of the argument block with the send quota in 
B18-B26 and the receive quota in B27-B35. The 
receive quota applies to the specified PID, but 
the send quota applies to the job to which that 
PID belongs. 

Argument 

PID 

15 .MUFFP Return all PIDs associated with the same process 

as that of the specified PID. The list of PIDs 
returned is in the same format as the list 
returned for the .MUFJP function (12) . 

Argument 

PID 

16 .MUSPQ Set the maximum number of PIDs allowed for the 

specified job. The caller must have IPCF 
capability enabled. 

Arguments 

job number or PID 
PID quota 

17 .MUFPQ Return the maximum number of PIDs allowed for the 

specified job. The PID quota is returned in word 
2 of the argument block. 

Argument 

job number or PID 
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20 .MUQRY Return the Packet Descriptor Block for the next 

packet in the queue associated with the specified 
PID. An argument of -1 returns the next 
descriptor block for the process, and an argument 
of -2 returns the next descriptor block for the 
job. The descriptor block is returned starting in 
word 1 of the argument block. The calling process 
and the process that owns the specified PID must 
belong to the same job. 

Argument 

PID 

21 .MUAPF Associate the PID with the specified process. The 

calling process and the process that owns the 
specified PID must belong to the same job. 

Arguments 

PID 

process handle 

22 .MUPIC Place the specified PID on a software interrupt 

channel. An interrupt is then generated when: 

1. The .MUPIC function is issued while the PID 
has one or more messages in its receive queue. 

2. The PID's receive queue changes its state from 
empty to containing a message. Subsequent 
entries to a queue that is not empty do not 
cause an interrupt. 

If the channel number is given as -1 , the PID is 
removed from its current channel. 

The calling process and the process that owns the 
specified PID must belong to the same job. 

Arguments 

PID 

channel number 

23 .MUDFI Set the PID of <SYSTEM>INFO. An error is given if 

<SYSTEM>INFO already has a PID. The caller must 
have IPCF capability enabled. 

Argument 

PID of <SYSTEM>INFO 
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Code 
24 



25 



Symbol Meaning 

.MUSSP Place the specified PID into the system PID table 
at the given offset. The caller must have WHEEL, 
OPERATOR, or IPCF capability enabled. See .MURSP 
for a list of system PIDs. 

Arguments 

index into system PID table 
PID 

.MURSP Return a PID from the system PID table. The PID 
is returned in word 2 of the argument block. The 
system PID table currently has the following 
entries : 



Reserved for DEC 
PID of <SYSTEM>INFO 
PID of QUASAR 
PID of QSRMDA 
PID of ORION 






.SPIPC 


1 


.SPINF 


2 


.SPQSR 


3 


.SPMDA 


4 


.SPOPR 



Argument 

index into system PID table 

26 .MUMPS Return the system-wide maximum packet size. The 

size is returned in word 1 of the argument block. 

27 .MUSKP Set PID to receive deleted PID messages. Allows a 

controller task to be notified if one of its 
subordinate tasks crashes. After this function is 
performed, if the subordinate PID is ever deleted 
(via RESET or the .MUDES MUTIL function) , the 
monitor will send an IPCF message to the 
controlling PID notifying it that the subordinate 
PID has been deleted. This message contains 
.IPCKP in word and the deleted PID in word 1. 

Argument 

Source (subordinate) PID 
Object (controller) PID 

30 .MURKP Return controlling PID for this subordinate PID. 

Argument 

Source (subordinate) PID 

Object (controller) PID (returned) 

MUTIL ERROR MNEMONICS: 



IPCFX2 
IPCFX3 
IPCFX4 
IPCFX5 
IPCFX6 



No message for this PID 

Data too long for user's buffer 

Receiver's PID invalid 

Receiver's PID disabled 

Send quota exceeded 
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IPCFX7: Receiver quota exceeded 

IPCFX8: IPCF free space exhausted 

IPCFX9: Sender's PID invalid 

IPCF10: WHEEL capability required 

IPCF11: WHEEL or IPCF capability required 

IPCF12: No free PID's available 

IPCF13: PID quota exceeded 

IPCF14: No PID's available to this job 

IPCF15: No PID's available to this process 

IPCF16: Receive and message data modes do not match 

IPCF17: Argument block too small 

IPCF18: Invalid MUTIL JSYS function 

IPCF19: No PID for [SYSTEM] INFO 

IPCF20: Invalid process handle 

IPCF21: Invalid job number 

IPCF22: Invalid software interrupt channel number 

IPCF23: [SYSTEM] INFO already exists 

IPCF24: Invalid message size 

IPCF25: PID does not belong to this job 

IPCF26: PID does not belong to this process 

IPCF27: PID is not defined 

IPCF28: PID not accessible by this process 

IPCF29: PID already being used by another process 

IPCF30: job is not logged in 

IPCF32: page is not private 

IPCF33: invalid index into system PID table 

IPCF35: Invalid IPCF quota 
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NIN 



JSYS 225 



Inputs an integer number, with leading spaces ignored. This call 

terminates on the first character not in the specified radix. If that 

character is a carriage return followed by a line feed, the line feed 
is also input. 

ACCEPTS IN AC1: source designator 

AC3: radix (2-10) of number being input 

RETURNS +1: failure, error code in AC3, updated string pointer, 
if pertinent, in ACI 

+2: success, number in AC2 and updated string pointer, if 
pertinent, in ACI 

NIN ERROR MNEMONICS: 

IFIXX1: Radix is not in range 2 to 10 

IFIXX2: First nonspace character is not a digit 

IFIXX3: Overflow (number is greater than 2**35) 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX5: File is not open 
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NODE JSYS 567 



Performs the following network utility functions: set local node 
name, get local node name, set local node number, get local node 
number, set loopback port, clear loopback port, and find loopback 
port . 

NOTE 

Some of these functions are duplicated 
in the NTMAN% JSYS, which is preferred. 

RESTRICTIONS: Some functions require WHEEL, OPERATOR, or 
MAINTENANCE capability, or TOPS-20, Version 5.1. 

ACCEPTS IN AC1: function code 

AC2: address of argument block 

RETURNS +1: always. If an error occurs, an illegal instruction 
trap is generated. 

The available functions and their argument blocks are described below. 
Code Symbol Function 

.NDSLN Set local node name 

Requires WHEEL or OPERATOR capabilities. 
Argument Block : 
Word Symbol Contents 
.NDNOD Byte pointer to ASCIZ node name. 

1 .NDGLN Get local node name 

Argument Block: 

Word Symbol Contents 

.NDNOD Byte pointer to destination for 
ASCIZ name of local node. 

2 .NDSNM Set local node number 

Requires WHEEL or OPERATOR capabilities. 

Argument Block : 

Word Symbol Contents 

.NDNOD Number to set (Phase II: 2 < n < 
12 7; Phase III: from 1 to 
.NDMAX) 
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.NDGNM 



.NDSLF 



■NDCLF 



•NDFLP 



NDSNT 



Get local node number 

Argument Block : 

Word Symbol Contents 

.NDNOD Returned node number 

Set loopback port (2020 only) 

Requires WHEEL, OPERATOR or 
capabil it ies . 



MAINTENANCE 



Argument Block 
Word Symbol 
.NDPRT 



Contents 

NSP port number. The .BTCLI 
function of the BOOT monitor call 
converts a line number to an NSP 
port number. 



Clear loopback port (2020 only) 



Requires WHEEL, 
capabil it ies . 



OPERATOR, 



MAINTENANCE 



Argument Block: 

Word Symbol Contents 

.NDPRT NSP port number. 
Find loopback port (2020 only) 
Argument Block: 



Word Symbol 
.NDPRT 



Contents 

NSP port number 

1B0(ND%LPR) Loopback running 

1B1 (ND%LPA) Loopback port assigned 

Set network topology. 

Sets the system's table of reachable nodes. 

Requires WHEEL or OPERATOR capabilities. 

Argument Block for monitors prior to TOPS-20, 
Version 5.1: 

Contents 



Number of following words in right 
half. Left half is reserved. 

Number of words in a node block 

Addresses of N node blocks (one 
for each node for which updated 
information is to be conveyed to 
the monitor) . 



Word 


Symbol 





.NDNND 


1 


.NDCNT 


2 


.NDBK1 
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NDSNT 
[Cont.) 



Node Block: 

Word Symbol 

.NDNAM 

1 .NDSTA 



Contents 

Byte pointer to ASCIZ node name 

Node state: 

.NDSON On 

Add to table of reachable nodes if 

not already there. 

.NDSOF Off 

Remove from table if previously 

there . 



.NDNXT 



Byte pointer to the DN20 name. 

Argument Block for TOPS-20, Version 5.1: 
Word Symbol Contents 

.NDNNO Number of nodes reported 



NDMSK 



Number of nodes 
topology message. 



Address of topology message 



The topology message is made up of 8-bit bytes. 
The bytes are left- just if ied within the topology 
message word. Each byte contains 4 2-bit fields. 

A two-bit field giving the topology status for a 
node has the following format: 

00 Node not reachable 

01 (reserved) 

10 Reachable Phase II node 

11 Reachable Phase III node 

The bit fields are packed four to a byte (see 

below), low-order to high-order. The first byte 

represents nodes 4, 3, 2, 1; the second byte 
represents nodes 10, 7, 6, 5; and so on. 



10 



14 13 12 11 20 17 16 15 



10 



NDGNT Get network topology. 

Reads the system's table of reachable nodes. 
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10 



, NDGNT 
'Cont.l 



11 



NDSIC 



Argument Block: 

Word Symbol 
.NDNND 



.NDCNT 



.NDBK1 



Contents 

Number of following words in the 
right half (set by the user on the 
call) and the number of nodes for 
which the monitor actually 
returned data in the left half 
(set by the monitor on return) . 

Number of words in a node block 
(returned) . 

Addresses of N node blocks (one 
for each node for which the 
monitor returned data; returned). 



.NDBK1+N Start of an area into which the 
monitor sequentially placed node 
blocks (described below). If 
there is not enough space to hold 
all of the information, the NODE 
JSYS will return as much data as 
will fit, and then fail with error 
code ARGX04. (Returned) 

Node Block (Returned) : 

Word Symbol Contents 

.NDNAM Byte pointer to the ASCIZ node 
name 



NDSTA 



Node state 
Code Symbol 

.NDSON 

1 .NDSOF 



Meaning 
On 
Off 



2 
3-4 



NDNXT 



Obsolete (always 0) 

ASCIZ node name (if node name .LE. 
4 characters, Word 4 NOT returned) 



12 



.NDCIC 



Set topology interrupt channel 

This function is used by a process wishing to be 
notified that the network topology has changed. 
The program must do the .NDGNT function to obtain 
the current topology. 

Argument Block: 

Word Symbol Contents 

.NDCHN Channel number on which interrupts 
are desired. 

Clear topology interrupt channel 
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This function is used to clear the request for 
interrupt on topology change (set by function 
.MDSIC) . 

13 .NDGVR Get NSP version number 

Argument Block : 

Word Symbol Contents 

.NDNVR Number of versions returned 

1 .NDCVR Address of a block in which the 

NSP communications version will be 
returned. (Block format is shown 
below . ) 

2 . NDRVR Address of a block in which the 

NSP routing version will be 
returned. (Block format is shown 
below . ) 

Version Block: 

Word Symbol Contents 

.NDVER Version number 

1 .NDECO ECO number 

2 .NDCST Customer change order 

14 .NDGLI Get line information 

Returns information on lines known to NSP. 

Argument Block : 

Word Symbol Contents 

.NDNLN Number of following words in right 

half (set by user on call) and 

number of lines (N) for which 

information was returned in the 

left half (set by monitor on 
return) . 

1 .NDBKl Addresses of N blocks of 

information for each line for 
which the monitor will return data 
to the user. The format of these 
blocks is described below. 

.NDEK1+N Start of an area into which the 
monitor will sequentially place 
line blocks (described below) . If 
there is not enough space to hold 
all of the information, the NODE 
JSYS will store as much as 
possible and then fail with error 
code ARGX04. 
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14 



.NDGLI 
(Cont.) 



15 



NDVFY 



16 



.NDRNM 
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Line Block 



Word Symbol 



.NDLNM 
.NDLST 



NDLND 



Contents 

line number 
State of Line 

..NDLON On 

..NDLOF Off 

..NDLCN Controller loopback 

..NDLCB Cable loopback 

Byte pointer to ASCIZ name of node 
at the end of the line. 



3 .NDLSZ Size of node block. 

Verify node name 

This function indicates whether the node name 
supplied by the user is in the monitor's database 
of known nodes, and if that node can be reached 
currently. 

Argument Block: 

Word Symbol Contents 

.NDNOD Byte pointer to ASCIZ node name to 

be checked. 

1 .NDFLG Flags returned by monitor. 

Flags : 



ND%EXM 



The specified node 
exactly matches a node 
name in the monitor's 
node database. 



Return a node name. 



This function converts a node number to 
name. (TOPS-20, Version 5.1 only) 



node 



Argument Block 
Word Symbol 

.NDNOD 

1 .NDCVR 



Contents 

The node number 

Byte pointer to area where the 
ASCIZ node name is to be returned. 



NODE ERROR MNEMONICS: 

ARGX02: Invalid function 

ARGX04: Argument block too small 

ARGX19: Invalid unit number 

CAPX2: WHEEL, OPERATOR, or MAINTENANCE capability required 
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COMX19: Too many characters in node name 

COMX20: Invalid node name 

MONX06: Insufficient system resources (No swappable free space' 

NODX02: Line not turned off 

NODX03: Another line already looped 

NSPX25: Illegal DECnet node number 

NSPX26: Table of topology watchers is full 
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NOUT 



JSYS 224 



Outputs an integer number. 
ACCEPTS IN AC1: destination designator 
number to be output 



AC2 
AC3 



B0(NO%MAG) output the magnitude. That is, output the 
number as an unsigned 36-bit number (e.g., 
output -1 as 777777 777777) . 

Bl (NO%SGN) output a plus sign for a positive number. 

B2(N0%LFL) output leading filler. If this bit is not 
set, trailing filler is output, and bit 
3(N0%ZR0) is ignored. 

B3(N0%ZR0) output O's as the leading filler if the 
specified number of columns (NO%COL) 
allows filling. If this bit is not set, 
blanks are output as leading filler if the 
number of columns allows filling. 

B4 (NO%OOV) output on column overflow and return an 
error. If this bit is not set, column 
overflow is not output. 

B5 (NO%AST) output asterisks on column overflow. If 

this bit is not set and bit 4 (NO%OOV) is 

set, all necessary digits are output on 
column overflow. 



B11-B17 
(NO%COL) 



B18-B35 
(NO%RDX) 



number of columns (including sign column) 
to output. If this field is 0, as many 
columns as necessary are output. 

radix (2-36) of number being output 



RETURNS 



+ 1 
+ 2 



failure, error code in AC3 

success, updated string pointer in AC1 , if pertinent 



NOUT ERROR MNEMONICS 



NOUTX1 

NOUTX2 

DESXl 

DESX2 

DESX3 

DESX5 

10X11 

10X34 

10X35 



Radix is not in range 2 to 36 
Column overflow 

Invalid source/destination designator 
Terminal is not available to this job 
JFN is not assigned 
File is not open 
Quota exceeded 
Disk full 

Unable to allocate disk - structure damaged 
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NTMAN% 



JSYS 604 



Provides an interface between the DECnet-20 Network Management layer 
and lower layers of the Digital Network Architecture. 

RESTRICTIONS: WHEEL or OPERATOR privileges are required. 

ACCEPTS IN AC1: address of argument block 

RETURNS: +1 always. If an error occurs, generates an illegal 
instruction trap, with error code returned in AC1 . 



NOTE 

Users of the NTMAN% JSYS should be 
familiar with the Network Management 
Specification. 



Format of Argument Block 



Word 


Symbol 





.NTCNT 


1 


.NTENT 



.NTEID 



.NTFNC 



.NTSEL 



Contents 

Number of words in this argument block 
Entity on which to perform function 
Code Symbol Meaning 



.NTNOD 
.NTLIN 
.NTLOG 
.NTCKT 
.NTMOD 



Node 

Line 

Logging 

Circuit 

Module 



Byte pointer to Entity ID. (See the Network 
Management Specification for format.) 

Function to be performed 

Code Symbol Meaning 



-2 
-1 

1 
2 
3 
4 
5 



.NTMAP Map node number /node name 

.NTREX Return the local node ID 

.NTSET Set Parameter 

.NTCLR Clear Parameter 

.NTZRO Zero all Counters 

.NTSHO Show selected Items 

.NTSZC Show and Zero All Counters 

.NTRET Return List of Items 



Selection criterion for function 
Selectors for Show Selected Items (.NTSHO) 
Code Symbol Meaning 



.NTSUM Summary 

.NTSTA Status 

.NTCHA Characteristics 

.NTCOU Counters 

.NTEVT Event 
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10 



.NTSEL 
(Cont.) 



Selectors for Return List of Items (.NTRET) 



.NTQUA 
.NTBPT 

.NTBYT 
.NTERR 



Code 

-1 
-2 
-3 



Symbol Meaning 



.NTKNO 
.NTACT 
.NTLOP 



Known Items 
Active Items 
Loop 



Byte pointer to function to qualifier 

Byte pointer to parameter data buffer. Pointer is 
updated to next available byte on return. 

Parameter data buffer length in bytes. Written in 
buffer for functions .NTMAP, .NTRET, .NTREX, 
.NTSHO, and .NTSZC. 

Network Management return code. (See the Network 
Management Specification for codes.) 



NTMAN% ERROR MNEMONICS: 

CAPX1: WHEEL or OPERATOR capability required 

ARGX09: Invalid byte size 

ARGX17: Invalid argument block length 

NTMX1: Network Management unable to complete request 
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ODCNV JSYS 222 

Converts the internal date and time format into separate numbers for 
local weekday, day, month, year, and time and does not convert the 
numbers to text. (Refer to Section 2.9.2 for more information.) The 
ODCNV call gives the caller the option of explicitly specifying the 
time zone and daylight savings time. 

ACCEPTS IN AC2: internal date and time, or -1 for current date and 
time 

AC4: B0(IC%DSA) apply daylight savings according to the 
setting of Bl(IC%ADS). If BO is off, 
daylight savings is applied only if 
appropriate for date. 

B1(IC%ADS) apply daylight savings if B0(IC%DSA) is 
on . 

B2(IC%UTZ) use time zone in B12-B17 (IC%TMZ) . If this 

bit is off, the local time zone is used. 
B3(IC%JUD) apply Julian day format (Jan 1 is day 1 in 
conversion) 
«» 
B12-B17 time zone to use if B2(IC%UTZ) is on. 
(IC%TMZ) 

RETURNS +1: always, with 

AC2 containing the year in the left half, and the 
numerical month (0=January) in the right half. 

AC3 containing the day of the month (0=first day) in 
the left half, and the day of the week (0=Monday) 
in the right half. 

AC4 containing 

BO and B2 on for compatibility with the IDCNV 

call 

B1(IC%ADS) on if daylight savings was applied 

B3(IC%JUD) on if Julian day format was applied 

B12-B17 time zone used 

(IC%TMZ) 

B18-B35 local time in seconds since midnight 

(IC%TIM) 

If IC%JUD is set, the Julian day (1 = Jan 1, 365 = non-leap Dec 31, 
366 = leap Dec 31, etc) is returned in the right half of AC2 and the 
left half of AC3 is set to zero. 

Generates an illegal instruction interrupt on error conditions below. 

ODCNV ERROR MNEMONICS: 

DATEX6: System date and time are not set 

TIMEX1: Time cannot be greater than 24 hours 

ZONEX1: Time zone out of range 
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ODTIM JSYS 220 



Outputs the date s.nd time by converting the internal format of the 
date and/or time to text. (Refer to Section 2.9.2.) 

ACCEPTS IN AC1: destination designator 

AC2: internal date and time, or -1 for current date and 
t ime 

AC3: format option flags (see below), is the normal case 

RETURNS +1: always, with updated string pointer in AC1 , if 
pertinent 

The format option flags in AC3 indicate the format in which the date 
and time are to be output. 

ODTIM Option Flags 

BO (OT%NDA) Do not output the date and ignore B1-B8. 

Bl(OT%DAY) Output the day of the week according to the format 
specified by B2 (OT%FDY) . 

B2(OT%FDY) Output the full text for the day of the week. If this 
bit is off, the 3-letter abbreviation of the day of the 
week is output. 

B3(OT%NMN) Output the month as numeric and ignore B4 (OT%FMN) . 

B4(OT%FMN) Output the full text for the month. If this bit is 
off, the 3-letter abbreviation of the month is output. 

B5(OT%4YR) Output the year as a 4-digit number. If this bit is 
off, the year is output as a 2-digit number if between 
1900 and 1999. 

B6(OT%DAM) Output the day of the month after the month. If this 
bit is off, the day is output before the month. 

B7(OT%SPA) Output the date with spaces between the items 
(e.g., 6 Feb 76). If B6 (OT%DAM) is also on, a comma 
is output after the day of the month (e.g., Feb 6, 76). 

B8(OT%SLA) Output the date with slashes (e.g., 2/6/76). 

If B7-B8 are both off, the date is output with dashes 
between the items (e.g., 6-Feb-76) . 

B9(OT%NTM) Do not output the time and ignore B10-B13. 

B10(OT%NSC) Do not output the seconds. If this bit is off, the 
seconds are output, preceded by a colon. 

Bll(OT%12H) Output the time in 12-hour format with AM or PM 
following the time. If this bit is off, the time is 
output in 24-hour format. 
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Bl2(OT%NCO) Output the time without a colon between the hours and 

minutes. 
B13(OT%TMZ) Output the time and follow it with a "-" and a time 

zone (e.g. , -EDT) . 

B17(OT%SCL) Suppress columnation of the date and time by omitting 
leading spaces and zeros. This produces appropriate 
output for a message. If this bit is off, the date and 
time are output in columns of constant width regardless 
of the particular date or time. However, full texts of 
months and weekdays are not columnated. This output is 
appropriate for tables. 

If AC3 is 0, the ODTIM call outputs the date and time in columns in 
the format 

dd-mmm-yy hh:mm:ss 

For example, 6-Feb-76 15:14:03. 

If AC3 is -1, the ODTIM call interprets the contents as if 
B1-B2,B4-B7, and B17 were on (i.e., AC3=336001000000) and outputs the 
date and time in the format 

weekday, month day, year hh:mm:ss 

as in Friday, February 6, 1976 15:14:03 

Additional examples are: 

Contents of AC3 Typical Text 

202201000000 Fri 6 Feb 76 1:06 

336321000000 Friday, February 6, 1976 1:06AM-EST 

041041000000 6/2/76 106:03 

041040000000 6/02/76 106:03 

Generates an illegal instruction interrupt on error conditions below. 

ODTIM ERROR MNEMONICS: 

DATEX6 : System date and time are not set 

TIMEX1: Time cannot be greater than 24 hours 

All I/O errors are also possible. These errors cause software 
interrupts or process terminations as described for the BOUT call 
description. 
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ODTNC JSYS 230 



Outputs the date and/or the time as separate numbers for local year, 
month, day, or time. (Refer to Section 2.9.2.) This JSYS is a subset 
of the ODTIM call because the output of dates and times not stored in 
internal format is permitted. Also, the caller has control over the 
time and zone printed. 



ACCEPTS IN AC1 
AC2 

AC3 
AC4 



AC5 



destination designator 

year in the left half, and 
(0=January) in the right half 



numerical month 



day of the month (0==first day) in the left half, and 
day of the week (0==Monday) , if desired, in the right 
half 

B1(IC%ADS) apply daylight savings on output 

B12-B17 (IC%TMZ) time zone in which to output 

B18-B35 (IC%TIM) local time in seconds since midnight 

format option flags (refer to ODTIM for the 
description of these flags) 



NOTE 

The only time zones that can be output by 
B13(OT%TMZ) are Greenwich and USA zones. 



RETURNS +1: always, with updated string pointer in AC1, if 
pertinent. 

Generates an illegal instruction interrupt on error conditions below. 

ODTNC ERROR MNEMONICS: 



DATEX1 
DATEX2 
DATEX3 
DATEX4 
ZONEX1 
ODTNX1 



Year out of range 

Month is not less than 12 

Day of month too large 

Day of week is not less than 7 

Time zone out or range 

Time zone must be USA or Greenwich 



All I/O errors can occur. These errors cause software interrupts or 
process terminations as described for the BOUT call description. 
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OPENF JSYS 21 

Opens the given file. Refer to the TOPS-20 Monitor Calls User's Guide 
for the explanations of the types of access allowed to a file. 

ACCEPTS IN AC1: JFN (right half of AC1) of the file being opened. 

AC2: B0-B5(OF%BSZ) Byte size (maximum of 36 decimal). If 

a zero byte size is supplied, the byte 
size defaults to 36 bits. 

B6-B9 (OF%MOD) Data mode in which to open file. 
Common data modes are: 



Code 


Symbol 


Mode 





.GSNRM 


Normal (ASCII) 


1 


.GSSMB 


Small buffer 


10 


.GSIMG 


Image 


17 


.GSDMP 


Dump 



(See Section 2.5 for more information 
on software data modes.) 

Useful modes for common devices are: 

Device Data Modes 

Disk .GSNRM 

Card Reader .GSNRM, .GSIMG 
Card Punch .GSNRM, .GSIMG 
PTY .GSNRM (PTY receives 

data in mode of 
its TTY) 
Mag Tape .GSNRM, .GSDMP 
TTY .GSNRM, .GSIMG 

B18(0F%HER) Halt on I/O device or data error. If 
this bit is on and a condition occurs 
that causes an I/O device or data error 
interrupt, the process will instead be 
halted, and an illegal instruction 
interrupt will be generated. If this 
bit is off and the condition occurs, 
the interrupt is generated on its 
normally-assigned channel. This bit 
remains in affect for the entire time 
that the file is open. 

B19(OF%RD) Allow read access. 

B20(OF%WR) Allow write access. 

B21(OF%EX) Allow execute access. 

B22(OF%APP) Allow append access. 



TOPS-20 Version 5 3-298 April 1982 



TOPS-20 MONITOR CALLS 
(OPENF) 



B23(OF%RDU) Allow unrestricted read access. This 
bit allows you to open a file for 
reading regardless of simultaneous 
thawed or frozen openings of the file 
for reading or writing by other 
processes or the process executing this 
call. You can use this bit only if you 
do not use the OF%THW or OF%WR bits. 

B25(OF%THW) Allow thawed access. If this bit is 
off, the file is opened for frozen 
access . 

Frozen access means there can be only 
one writer of the file; thawed access 
means there can be many writers of the 
file. A program manipulating a thawed 
file must take into account the fact 
that other programs may open and modify 
that file. Thawed/frozen access has no 
direct effect on readers of the file, 
but it does have the indirect effect 
that is described in the next 
paragraph. 

The first open of a file sets the 

precedent for future opens: if the 

first open is thawed, then all 
subsequent opens must be thawed, 

regardless if read or write access is 

desired. The same holds true for 

frozen access. This condition is in 

effect until the last close of the 
file. 

See the descriptions of bits OF%DUD and 
OF%RDU for the interaction of OF%THW 
with those bits. Also, see the 
description of the PMAP JSYS for the 
interaction of PMAP bit PM%ABT with 
OF%DUD. 

B26(OF%AWT) Block program and print a message on 
the job's controlling terminal if 
access to file cannot be permitted. 
The program is blocked until access is 
granted . 

B27(OF%PDT) Do not update access dates of the file. 

B28(OF%NWT) Return an error if access to file 
cannot be permitted. 

If B26 and B28 are both off, the 
default is to return an error if access 
to the file cannot be granted. 

B29(OF%RTD) Enforce restricted access. No other 
JFN in the system may be opened with 
this file until the current JFN is 
released . 
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B30(OF%PLN) Disable line number checking and 
consider a line number as 5 characters 
of text. 

B31(OF%DUD) Suppress the system updating of 

modified pages in memory to thawed 

files on disk. This bit is ignored for 
new files. 

Ordinarily, TOPS-20 automatically 
updates modified memory pages to disk 
approximately once each minute. OF%DUD 
prohibits this automatic update. 
However, there are three sources of 
"manual" updating that are not 
controlled by OF%DUD: 

1. A CLOSF is performed 

2. A UFPGS is performed 

3. Swapping space becomes full 

OF%DUD and OF%THW interact in the 
following ways: 

OF%THW OF%DUD Effect 

- OF%DUD ignored 

1 Perform automatic 

file page update 
1 1 Suppress automatic 
file page update 

B32(OF%OFL) Open the device even if it is off line. 

B33(OF%FDT) Force an update of the .FBREF date and 
time (last read) in the FDB . Also, 
increment right halfword (number of 
file references) of . FBCNT count word 
in the FDB. 

B34(OF%RAR) Wait if the file is offline. 

RETURNS +1: failure, error code in AC1 

+2: success 

Even though each type of desired file access can be indicated by a 
separate bit, some accesses are implied when specific bits are set. 
For example, the setting of the write access bit implies read access 
if the process is allowed to read the file according to the file's 
access code. This means that if the process has access to read the 
file and it sets only the write access bit, the process will have the 
file opened for read, write, and execute access. However, if an 
existing file is opened and only write access is specified (only OF%WR 
is set), the contents of the file are deleted, and the file is 
considered empty. Thus, to update an existing file, both OF%RD and 
OF%WR must be set. 
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Note that if OF%RD, OF%WR, and OF%APP are all zero, OPENF will 
generate an error. OPENF works as follows for archived and migrated 
files: 



OPENF Access 

Read 

Write 

Append 



Archived 
Online 

Ok 

Fail 
Fail 



Offline 

Fail/Wait 

Fail 

Fail 



OPENF Access 

Read 
Write 



Append 



Migrated 

Online 

Ok 
Ok 

(discard 
implied) 
Ok 

(discard 
implied) 



Offline 
Fail /Wait 



Fail/Wait 
(discard 
impl ied) 



The failure cases return an error message (OPNXnn) . The fail/wait 
cases return an error for failure or wait until the OPENF can be 
successfully completed. 

The settings of OF%NWT (never wait for file restore) and OF%RAR 
(retrieve file if necessary) determine whether a failure or wait 
occurs. If OF%NWT is set on the OPENF call, OPENF alway fails (in the 
fail/wait cases) . If OF%RAR or the job default (See the SETJB monitor 
call.) is set, the OPENF will wait for the file to be retrieved, and 
then complete successfully. In the Ok (discard implied) cases, tape 
pointers for the file, if any, are discarded. 

The CLOSF monitor call can be used to close a specific file. 

OPENF ERROR MNEMONICS: 



0PNX1 
OPNX2 
OPNX3 
OPNX4 
OPNX5 
OPNX6 
OPNX7 
OPNX8 
OPNX9 



File is already open 

File does not exist 

Read access required 

Write access required 

Execute access required 

Append access required 

Device already assigned to another job 

Device is not on line 

Invalid simultaneous access 
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OPNX10 

OPNX12 

OPNX13 

OPNX14 

OPNX15 

OPNX16 

OPNX17 

OPNX18 

OPNX23 

OPNX2 5 

OPNX26 

DESX1 

DESX3 

DESX4 

DESX7 

SFBSX2 

TTYXOl 



Entire file structure full 

List access required 

Invalid access requested 

Invalid mode requested 

Read/write access required 

File has bad index block 

No room in job for long file page table 

Unit Record Devices are not available 

Disk quota exceeded 

Device is write-locked 

Illegal to open a string pointer 

Invalid source/destination designator 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 

Invalid byte size 

Line is not active 
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PBIN JSYS 73 

Inputs the next sequential byte from the primary input designator. 
This call is equivalent to a BIN call with the source designator given 
as .PRIIN. 

RETURNS +1: always, with the byte right- justified in AC1 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 

PBIN ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX5: File is not open 

IOX1: File is not open for reading 

IOX4: End of file reached 

10X5: Device or data error 



3-303 



TOPS-20 MONITOR CALLS 
(PBOUT) 



PBOUT JSYS 74 



Outputs a byte sequentially to the primary output designator. This 
call is equivalent to a BOUT call with the destination designator 
given as .PRIOU. 

ACCEPTS IN AC1: byte to be output, right-justified 

RETURNS +1: always 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 

PBOUT ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX5 

IOX2 

10X5 

10X6 

10X11: 

10X34: 

10X35: 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

File is not open for writing 

Device or data error 

Illegal to write beyond absolute end of file 

Quota exceeded 

Disk full 

unable to allocate disk - structure damaged 
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PDVOP% JSYS 603 



Manipulates program data vectors (PDV's), which begin at program data 
vector addresses (PDVA's). Program data vectors are used to allow 
user programs to obtain information about execute-only programs. 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



function code 

address of the argument block 

byte pointer to a string in memory 

always, with data returned in the data block, an 
updated count in .POCT2 if needed. 



The following describes the format of the argument block to which the 
address in AC2 points. 



Word 



Symbol 



Meaning 



.POCT1 

.POPHD 
.POCT2 



Count 1, the number of words in the argument 
block . 

Handle of the process that the call is to affect 

Count 2, the number of words in the data block. 
The call returns two counts in this word. The 
left half contains the number of words of data 
available for the call to return, and the right 
half contains the number of words the call did 
return in the data block. If the right half is 
smaller than the left half, the call could not 
return all the data available due to a lack of 
room in the data block. 



.PODAT 
. POADR 



Starting address of the data block into which 

call returns data 

Starting address of the range of memory 



the 



5 . POADE Ending address of the range of memory 
The format of a program data vector is as follows: 
Word Symbol Meaning 



2 


. PVSTR 


3 


.PVREE 


4 


.PVVER 


5 


.PVMEM 



PVCNT Length of the PDV (including this word) . 

PVNAM The address of the name of the program for 
which this data vector exists. The name is 
in ASCIZ representation. (In most cases, a 
byte pointer should be created to access this 
string . ) 

Program starting address. 
Program reenter address. 
Program version number. 

Address of a block of memory that, contains 
data describing the program's address space 
(a memory map). See the LINK manual, 
Appendix G, for a description of this block. 

PVSYM Address of the program symbol table. 

PVCTM Time at which the program was compiled. 
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Word 



Symbol 



10 


. PVCVR 


11 


.PVLTM 


12 


. PVLVR 


13 


. PVMON 


14 


.PVPRG 


15 


.PVCST 



Meaning 

Version number of the compiler. 

Time at which the program was loaded. 

Version number of LINK. 

Address of a monitor data block. 

currently used.) 

Address of a program data block. 

currently used . ) 

Address of a customer-defined data block. 



(Not 
(Not 



Functions that require a range of memory locations (.POGET and .POREM) 
interpret words . POADR and .POADE as follows: 

o If .POADR and .POADE are both nonzero, then .POADR contains 

the first address in the range, .POADE contains the last 

address in the range, and the range includes all the 
addresses between them. 

o If both .POADR and .POADE are zero, the range is all of 
memory . 

o If .POADE is zero and .POADR is not, the range begins at 
.POADR and includes all higher addresses in the rest of 
memory . 

o If .POADE is not zero, and .POADR is larger than .POADE, an 
error results. 

You can use the following function codes in AC1. 

Code Symbol Function 







.POGET For the process specified in word .POPHD of the 
argument block, this function returns all PDVA ' s 
within the range of addresses specified in words 
.POADR and .POADE of the argument block. 

.POADD This function adds the PDVA ' s specified in the 

data block to the system's data base for the 

specified process. The PDVA ' s must be in 
ascending order within the data block. 

.POREM This function removes a set of PDVA ' s from the 
system's data base for the specified process. The 
PDVA ' s removed are the ones within the range of 
addresses specified in words .POADR and .POADE of 
the argument block. 

.PONAM This function returns the ASCIZ name of a program 
in memory. Word .POADR of the argument block must 
contain a valid PDVA for the specified process. 
The name returned is the one to which word .PVNAM 
of the PDV points. 

.POVER This function returns the version of a program in 

memory. Word .POADR must contain a valid PDVA for 

the specified process. The version returned is 
the one that word .PVVER of the PDV contains. 

. POLOC For the specified process, this function returns 
all the PDVA ' s of PDV's for the specified program. 
The byte pointer in AC3 points to the program 

name. 
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This call generates an illegal instruction interrupt on the error 
conditions below. 

PVDOP% ERROR MNEMONICS: 



MONX02 
PDVX01 
PDVX0 2 
PDVX0 3 



Insufficient system resources (JSB full) 

Address in .POADE must be as large as address in . POADR 
Addresses in . PODAT block must be in strict ascending order 
Address in .POADR must be a program data vector address 
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PEEK JSYS 311 

Transfers a block of words from the monitor to the user space. The 
desired monitor pages must have read access. This monitor call is 
used to obtain data from the monitor for maintenance and test purposes 
and should be executed only when GETAB information is not available. 

RESTRICTIONS: requires WHEEL, OPERATOR, or MAINTENANCE capability 
enabled 

ACCEPTS IN AC1: word count in the left half, and first virtual 
address of the monitor in the right half 

AC2: first user address 

RETURNS +1: failure, error code in AC1 

+2: success, the desired words are transferred. 

PEEK ERROR MNEMONICS: 

CAPX1: WHEEL or OPERATOR capability required 

PEEKX2: Read access failure on monitor page 
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PLOCK JSYS 561 

Acquires physical memory and places a designated section of the 
process 1 address space in memory. Allows the process to specify the 
memory pages to be used, or permits the system to select the pages. 

RESTRICTIONS: requires WHEEL, OPERATOR, or MAINTENANCE capability 
enabled 

ACCEPTS IN AC1: address of first page if acquiring (locking) or -1 if 
unlocking . 

AC2: process handle (currently . FHSLF only) in the left 
half and number of first page in the right half. 

AC3: control flags in the left half and repeat count in 
the right half. The control flags are: 

BO (LK%CNT) right half of AC3 contains a count of the 
number of pages to lock. 

Bl (LK%PHY) value in AC1 is the first page desired. 
If this bit is off and AC1 is not -1, the 
system selects pages. 

B2 (LK%NCH) pages will not be cached. 

B3 (LK%AOL) off-line pages are to be locked. 

RETURNS +1: always 

If the PLOCK call is unable to honor any one of the requests to unlock 
any one of the pages specified by the repeat count, it will unlock all 
of the others. 

A page that was locked with the PLOCK call may be unmapped. (Refer to 
the PMAP call.) This will unlock the process' page and return the now 
unlocked physical page to its previous state. 

The page selected by the user must be capable of being placed off-line 
for the PLOCK call to acquire it. 

Generates an illegal instruction interrupt on error conditions below. 

PLOCK ERROR MNEMONICS: 

ARGX22: Invalid flag 

ARGX24 invalid count 
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PMAP JSYS 56 



Maps one or more complete pages from a file to a process (for input), 

from a process to a file (for output) , or from one process to another 

process. Also unmaps pages from a process and deletes pages from a 
file. Each of the five uses of PMAP is described below. 

Case I: Mapping File Pages to a Process 

This use of the PMAP call does not actually transfer any data; it 
simply changes the contents of the process 1 page map. When changes 
are made to the page in the process, the changes will also be 
reflected in the page in the file, if write access has been specified 
for the file. 



ACCEPTS IN AC1 



AC2 



AC3 



JFN of the file in the left half, and the page number 
in the file in the right half. This AC contains the 
source . 

process handle in the left half, and the page number 
in the process in the right half. This AC contains 
the destination. 

B0(PM%CNT) A count is in the right half of AC3. 
This count specifies the number of 
sequential pages to be mapped. If this 
bit is not set, one page is mapped. 

B2(PM%RD) Permit read access to the page. 

B3(PM%WR) Permit write access to the page. 

B4(PM%EX) Reserved for future use. 

The symbol PM%RWX can be used to set 
B2-B4. 

B5(PM%PLD) Preload the page being mapped (move the 
page immediately instead of waiting until 
it is referenced) . 

B9(PM%CPY) Create a private copy of the page when it 
is written into (copy-on-wr i te) . If the 
page is mapped between two processes 
(Case III below) , both processes will 
receive a private copy of the page. 

B10(PM%EPN) The right half of AC2 contains a process 
page number. If the section containing 
the page does not exist, a private 
section is created. 

B11(PM%ABT) Unmap a page and throw its changed 
contents away. This bit is significant 
only when unmapping process pages that 
were mapped from a file (see case IV 
below) and OF%DUD is set in the OPENF. 

Normally, if a page is unmapped and has 
been changed since the last time the 
monitor updated the associated file page, 
the monitor will remove the page from the 
process and place it on a queue in order 
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to update the file page. PM%ABT allows 
the page to be unmapped, but prevents the 
monitor from placing the page on the 
update queue. 

This feature is useful in the case of 
erroneous data written to a mapped page 
of a file open for simultaneous access. 
In this case, it is important that the 
erroneous page be discarded and not be 
used to update the file page. Another 
application is to allow processes in 
separate jobs to communicate by sharing a 
file page (and reading/writing the page) 
and avoid the overhead of the monitor 
periodically updating the page. 

B18-B35 Number of pages to be mapped if 
(PM%RPT) B0(PM%CNT) is set. 

RETURNS +1: always 

This use of PMAP changes the map of the process such that addresses in 
the process page specified by the right half of AC2 actually refer to 
the file page specified by the right half of AC1. The present 
contents of the process page are removed. If the page in the file is 
currently nonexistent, it will be created when it is written (when the 
corresponding page in the process is written). If the process page is 
in a nonexistant section, an illegal instruction trap is generated. 

This use of PMAP is legal only if the file is opened for at least read 
access. The access bits specified in the PMAP call are ANDed with the 
access that was specified when the file was opened. However, 
copy-on-wr i te is always granted, regardless of the file's access. The 
access granted is placed in the process 1 map. The file cannot be 
closed while any of its pages are mapped into any process. Thus, 
before the file is closed, pages must be unmapped from each process by 
a PMAP call with -1 in AC.1 (see below) . 

Case II Mapping Process Pages to a File 

This use of the PMAP call actually transfers data by moving the 
contents of the specified page in the process to the specified page in 
the file. The process 1 map for that page becomes empty. 

ACCEPTS IN AC1: process handle in the left half, and the page number 
within the process in the right half. This AC 
contains the source. 

AC2: JFN of the file in the left half, and the page number 
within the file in the right half. This AC contains 
the destination. 

AC3 : access bits and repetition count. (Refer to Case I.) 

RETURNS +1: always 

The process page and the file page must be private pages. The 
ownership of the process page is transferred to the file page. The 
present contents of the page in the file is deleted. 

The access granted to the file page is determined by ANDing the access 
specified in the PMAP call with the access specified when the file was 
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opened. This function does not update the file's byte size or the 
end-of-file pointer in the file's FDB . Failure to update these items 
in the FDB can prevent the reading of the file by sequential I/O calls 
such as BIN and BOUT. 

To update the file's FDB after using this PMAP function, do the 
following : 

1. Use the CLOSF call with the CO%NRJ bit set to close the file 
but keep the JFN. 

2. Use the CHFDB call to update the end-of-file pointer and, if 
necessary, the byte size in the*file's FDB. 

3. Use the RLJFN call to release the JFN. 

(Refer to Section 2.2.8 for the format of the FDB fields.) 

Case III Mapping One Process* Pages to Another Process 

This use of the PMAP call normally does not transfer any data; it 
simply changes the contents of the page maps of the processes. When 
changes are made to the page in one process, the changes will also be 
reflected in the corresponding page in the other process. 

ACCEPTS IN AC1: process handle in the left half, and the page number 
in the process in the right half. This AC contains 
the source. 

AC2: a second process handle in the left half, and page 
number in that process in the right half. This AC 
contains the destination. 

AC3: access bits and repetition count. (Refer to Case I.) 

RETURNS +1: always 

This use of PMAP changes the map of the destination process such that 
addresses in the page specified by the right half of AC2 actually 
refer to the page in the source process specified by the right half of 
AC1. The present contents of the destination page are deleted. 

The access granted to the destination page is determined by the access 
specified in the PMAP call. If the destination page is in a 
nonexistant section, the monitor generates an illegal instruction 
trap . 

Case IV Unmapping Pages In a Process 

As stated previously, a file cannot be closed if any of its pages are 
mapped in any process. 

ACCEPTS IN AC1: -1 

AC2: process handle in the left half, and page number 
within the process in the right half 

AC3: B0(PM%CNT) Repeat count. Only the process page 

numbers are incremented. 

B18-B35 Number of pages to remove from process 
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This format of the PMAP call removes the pages indicated in AC2 from 
the process. 

A page that was locked with the PLOCK call may be unmapped. Doing so 
will unlock the process 1 page and return the now unlocked physical 
page to its previous state. 

Case V Deleting One or More Pages from a File 

Deletes one or more pages from a file on disk and does not affect the 
address space of any process. 

ACCEPTS IN AC1: -1 

AC2: JFN of the file in the left half and page number 
within the file in the right half. 

AC3: B0(PM%CNT) Indicates that the right half contains 
the number of pages to delete. 

B18-35 Number of pages to delete from file 

Illegal PMAP calls 

The PMAP call is illegal if: 

1. Both AC1 and AC2 designate files. 

2. Both AC1 and AC2 are 0. 

3. The PMAP call designates a file with write-only access. 

4. The PMAP call designates a file with append-only access. 

5. The source and/or the destination designates an execute-only 
process and the process is not self (.FHSLF). 

Can cause several software interrupts on certain file conditions. 

Generates an illegal instruction interrupt on error conditions below. 

PMAP ERROR MNEMONICS: 

APGX06: Invalid page number 

CFRKX3: Insufficient system resources 

DESXl: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX5: File is not open 

DESX7: Illegal use of parse-only JFN or output wildcard-designators 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 

FRKHX7: Process page cannot exceed 777 

FRKHX8: Illegal to manipulate an execute-only process 
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10X34: 
10X35: 
LNGFX1 
PMAPX1 
PMAPX2 
PMAPX3 
PMAPX4 
PMAPX5 
PMAPX6 
PMAPX7 
PMAPX8 
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Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 

Page table does not exist and file not open for write 

Invalid access requested 

Invalid use of PMAP 

Illegal to move shared page into file 

Illegal to move file page into process 

Illegal to move special page into file 

Disk quota exceeded 

Illegal to map file on dismounted structure 

Indirect page map loop detected 
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PMCTL JSYS 560 



Controls physical memory. This call allows a privileged program to 
add or remove most pages of physical memory and to control use of 
cache memory. 



RESTRICTIONS: 

ACCEPTS IN AC1 

AC2 

AC3 

RETURNS +1 



Requires WHEEL or OPERATOR capability enabled 

function code 

length of the argument block 

address of the argument block 

always 



The defined functions and their argument blocks are as follows 



Function 




Symbol 
.MCRCE 



MCSCE 



•MCRPS 



Meaning 

Return the status of cache memory. The 
status is returned in word .MCCST of the 
argument block. 



Argument Block 
.MCCST 



If B35(MC%CEN) is on, the cache 
is enabled. 



Set the status of cache memory 
Argument Block 
.MCCST 



Enable the cache if B35(MC%CEN) 
is on. 



Return the status of the given page(s). The 
number of the page is given in word .MCPPN, 
and its status is returned in word .MCPST. 



Argument Block 

.MCPPN Negative count in the left half; 

number of physical page in the 
right half 

1 .MCPST Returned page status. The 

status is represented by one of 
the following values: 

.MCPSA Page is available 

for normal use. 

1 .MCPSS Page is in a 

transition state. 

2 .MCPSO Page is off line because it is 

nonexistent. Nonexistent memory 
is marked as off line at system 
startup . 

3 .MCPSE Page is off line because the 

monitor detected an error. 
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3 .MCSPS Set the status of the given page. The number 

of the page is given in word .MCPPN, and the 
status value is given in word .MCPST. 

Argument Block 

.MCPPN Numoer of physical page. 

1 .MCPST Status for page. The status is 

represented by one of the 
following values: 

.MCPSA Mark page available 
for normal use. 

2 .MCPSO Mark page off line 

because it does not 
exist. 

3 .MCPSE Mark page off line 

because it has an 
error . 

4 .MCRME Collect information 

about MOS memory 
errors. Store the 
information in 
block addressed by 
AC3 and update AC2 
on return. 

A list of those pages that PMCTL cannot acquire follows: 

1. the EPT 

2. the monitor's UPT 

3. any page containing a CSTO entry 

4. any page containing an SPT entry 

5. the page containing MMAP 

6. any page belonging to the resident free space pool 

In certain specialized monitors, for example TOPS-20AN, there are 
additional pages that cannot be acquired. An estimate of the size of 
these areas follows: 

CSTO one word for every page of memory supported (two to four 

pages) 
SPT four pages 
MMAP one page 
Resident Free Space Pool two pages minimum 
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Generates an illegal instruction interrupt on error conditions below, 

PMCTL ERROR MNEMONICS: 

CAPX2: WHEEL, OPERATOR, or MAINTENANCE capability required 

PMCLX1: Invalid page state or state transition 

PMCLX2: Requested physical page is unavailable 

PMCLX3: Requested physical page contains errors 

ARGX02: Invalid function 

ARGX06: Invalid page number 
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PPNST JSYS 557 



Translates a project-programmer number (a TOPS-10 36-bit directory 
designator) to its corresponding TOPS-20 string. The string consists 
of the structure name and a colon followed by the directory name 
enclosed in brackets. This monitor call and the STPPN monitor call 
should appear only in programs that require translations of 
project-programmer numbers. Both calls are temporary calls and may 
not be defined in future releases. 



ACCEPTS IN AC1 
AC2 
AC3 



RETURNS 



+ 1 



destination designator 

project-programmer number (36 bits) 

byte pointer to structure name string for which the 
given project-programmer number applies. 

always, with string written to destination, with 
updated byte pointer, if pertinent, in AC1 



If the structure name string is a logical name, then the first 
structure appearing in the logical name definition is used. 

Generates an illegal instruction interrupt on error conditions below. 

PPNST ERROR MNEMONICS: 

PPNX1: Invalid PPN 

PPNX2: Structure is not mounted 

GJFX22: Insufficient system resources (Job Storage Block full) 

STDVX1: No such device 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX5: File is not open 

DELFX6: Internal format of directory is incorrect 

DIRX1: Invalid directory number 

DIRX2: Insufficient system resources 

DIRX3: Internal format of directory is incorrect 

STRX01: Structure is not mounted 

STRX06: No such user number 

10X11: Quota exceeded 

10X34: Disk full 

10X35: Unable to allocate disk - structure damaged 
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PRARG 



JSYS 545 



Returns or sets up an argument block for the specified process. The 
monitor stores the argument block in process storage block for this 
process . 

This call is useful for running a program whenever another program 
halts. Examples are running a compiler or re-executing the last 
compile-class command each time you exit an editor. 

This call uses the 200-word process storage block associated with each 
process. User programs can only access this memory by means of the 
the PRARG monitor call. A process and all of its superior processes 
can access the process storage block of a given process. Furthermore, 
data associated with many different programs can be stored a given 
process storage block. 



ACCEPTS IN AC1 

AC2 

AC3 

RETURNS +1 



function code in the left half, and a process handle 
in the right half 

address of argument block 

length of argument block 

always, with the number of words of data in the 
returned argument block in AC3 



The codes for the functions are as follows: 

1 . PRARD return the arguments beginning at the address 

specified in AC2 

2 .PRAST set the arguments using the argument block at the 

address specified in AC2 

The PRARG argument block has the following format: 
Offset Meaning 



Number of argument blocks 

Relative address (from the start of this block) of the 

first argument 

list 

Relative address of the second argument list 



N 



Relative address of the Nth argument list 



The argument list format is the following: 

Word Meaning 

Number of argument lists (must be 1) 

1 Entry type in the left half (must be 400740) , and the 
address, relative to the start of the argument block, 
of the argument list in the right half (usually 2, but 
other relative addresses are allowed) 

The argument list contains an ASCIZ string that is the name of the 
program to run; or the list contains a zero, which means that the 
last compile-class command is to be re-executed. 
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Generates an illegal instruction interrupt on error conditions below 
PRARG ERROR MNEMONICS: 



PRAX1 
PRAX2 
PRAX3 



Invalid PRARG function code 

No room in monitor data base for argument block 

PRARG argument block too large 
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(PSODT) 

PSOUT JSYS 76 



Outputs a string sequentially to the primary output designator. 

ACCEPTS IN AC1: byte pointer to an ASCIZ string in the caller's 
address space 



RETURNS 



+1: always, with updated byte pointer in AC1 



Can cause several software interrupts or process terminations on 
certain file conditions.. (Refer to bit OF%HER of the OPENF call 
description . ) 

PSOUT ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX5 
IOX2: 
IOX5: 
10X6: 
10X11 
10X34 
10X35 



Invalid source/destination designator 

Terminal, is not available to this job 

JFN is not assigned 

File is not open 

File is not open for writing 

Device or data error 

Illegal to write beyond absolute end of file 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 



TOPS-20 Version 5 



3-321 



April 1982 



TOPS-20 MONITOR CALLS 
(RCDIR) 

RCDIR JSYS 553 

Translates the given directory string to its corresponding 36-bit 
directory number. 

A directory string contains a structure name and a directory name. 
The structure name must be followed by a colon, and the directory name 
must be enclosed in either square brackets or angle brackets. No 
spaces can appear between the structure name and the directory name. 
Here is an example of a directory string: 

PS:<SMITH> 

Recognition cannot be used on the structure name. If the structure 
name is omitted from the string, the user's connected structure is 
used. Wildcards cannot be used in the structure name field. 

Recognition can be used on the directory name field. Recognition can 
also be used on part of the directory name field, so that a user can 
employ recognition when typing the name of a subdirectory. When 
recognition is used on the directory name field, and the directory 
name is not ambiguous, the closing bracket is not required. 

Wildcards can be used in the directory name field. Repeated RCDIR 
calls can be executed to obtain the numbers of the directories whose 
names match the given directory string. After the first call, each 
subsequent RCDIR call returns the number of the next directory that 
matches the directory string. 

RESTRICTIONS: When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

ACCEPTS IN AC1: flag bits in the left half 

AC2: byte pointer to ASCIZ string to be translated, a JFN, 
a 36-bit user number, or a 36-bit directory number 
(given for the purpose of checking its validity) 

AC3: 36-bit directory number (given when stepping to the 
next directory in a group of directories) 

RETURNS +1: always, with 

AC1 containing flag bits in the left half 

AC2 containing an updated byte pointer (if a pointer 
was supplied as the argument). If recognition 
was used, this pointer reflects the remainder of 
the string that was appended to the original 
str ing . 

AC3 containing a 36-bit directory number if execution 
of the call was successful 

The flag bits supplied in the left half of AC1 are as follows: 
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B14(RC%PAR) Allow partial recognition on the directory name. If 

the name given matches more than one directory, bit 

RC%AMB is set on return and the string is updated to 
reflect the unique portion of the directory name. 

If bit RC%PAR is not set, the name given matches more 
than one directory, and recognition is being used, then 
bit RC%AMB is set on return, but the string is not 
updated . 

B15(RC%STP) Step to the next directory in the group and return the 
number of that directory. AC1 must have bit RC%AWL 
set. AC2 must contain a pointer to a string that 
contains wildcard characters in the directory name 
field. ACS must contain a directory number. 

B16(RC%AWL) Allow the directory name to contain wildcard 
characters. The directory name must include its 
terminating bracket. No recognition is performed on a 
directory name that contains wildcard characters. 

This bit must be set if bit RC%STP is also set. 

B17(RC%EMO) Match the given string exactly. When both the RC%PAR 
and RC%EMO bits are on, recognition is not used on the 
string, and the string is matched exactly. 

If this bit is off, recognition is used on the string. 

The flag bits returned in the left half of AC1 are as follows: 

On success 

BO (RC%DIR) Directory can be used only by connecting to it. (It is 
a files-only directory.) 

If this bit is off, the user can also login to (if the 
directory is on the public structure) or access this 
directory. 

B1(RC%ANA) Obsolete 

B2(RC%RLM) All messages from <SYSTEM>MAIL. TXT are repeated every 
time the user logs in. If this bit is off, messages 
are printed only once.. 

B6 (RC%WLD) The directory name given contained wildcard characters. 

On failure 

B3(RC%NOM) No match was found for the string given. This bit is 
returned if either 1) bit RC%EMO was on in the call, 
and a string was given that matched more than one 
directory; or 2) the syntax of the fields in the 
string is correct, but the structure is not mounted, or 
the directory does not exist. 
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(RCDIR) 

B4(RC%AMB) The argument given was ambiguous. This bit is returned 
if bit RC%EMO was off, and if the string given either 
matched more than one directory, or did not include the 
beginning bracket of the directory name field. 

B5 (RC%NMD) There are no more directories in the group of 

directories. This bit is returned if RC%STP was on and 

the numbers of all the directories in the group have 
been returned. 

The RCDIR monitor call can be used in one of two ways. The simpler 
way is to translate a directory string to its corresponding 36-bit 
directory number. The string can be either recognized, or matched 
exactly. 

The second way of using the RCDIR call is to provide a directory 
string that corresponds to more than one directory, and then use 
repeated RCDIR calls to step through all the directories matching the 
given string. Each call obtains the number of the next directory that 
matches the given string. When no more directories match the string, 
the RC%NMD bit is set on the call's return. 

When obtaining a single directory number, RCDIR can accept a JFN, a 
36-bit user number, or a directory number. When a JFN is supplied as 
an argument, the number returned is that of the directory containing 
the file associated with the JFN. When a user number is supplied as 
an argument, the number returned is the logged-in directory for that 
user. When a directory number is supplied, the RCDIR call checks the 
number's validity. If the number is valid, the RCDIR call is 
successful, and this same number is returned. 

When obtaining several directory numbers, RCDIR requires AC2 to 
contain a pointer to a directory string that contains wildcard 
characters. If the string does not contain wildcards, or if any thing 
other than a string pointer is given in AC2, the stepping function is 
not performed, and the call returns with the RC%NMD bit set. 

Furthermore, the first RCDIR call executed must have bit RC%AWL set in 
AC1, and the pointer to the string in AC2. If execution of the call 
is successful, AC3 contains the number of the directory corresponding 
to the first directory that matches the given directory string. For 
example, if the string given is <SMITH*> and the call is successful, 
the number returned corresponds to <SMITH>. 

Subsequent RCDIR calls must set bits RC%STP and RC%AWL in AC1, reset 
the pointer in AC2 (because it is updated on a successful RCDIR call) , 
and leave in AC3 the directory number returned from the previous RCDIR 
call. The directory number in AC3 is accepted only if RC%STP is set 
in AC1, and a pointer to a string containing wildcard characters is 
given in AC2. 

On successful execution of each subsequent RCDIR call, the number 
returned in AC3 corresponds to the next directory in the group. When 
the number of the last directory in the group has been returned, a 
subsequent RCDIR call sets bit RC%NMD in AC1; the content of AC3 is 
indeterminate . 

The RCUSR monitor call can be used to translate a user name string to 
its corresponding user number. The DIRST monitor call can be used to 
translate either a directory number or a user number to its 
corresponding string. 
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(RCDIR) 

Generates an illegal instruction interrupt on error conditions below. 

RCDIR ERROR MNEMONICS: 

RCDIXl: Insufficient system resources 

RCDIX2: Invalid directory specification 

RCDIX3: Invalid structure name 

RCDIX4: Monitor internal error 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX7: Illegal use of parse-only JFN or output wildcard-designators | 

DESX8: File is not on disk 

DESX10: Structure is dismounted 

STRX01: Structure is not mounted 
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TOPS-20 MONITOR CALLS 
(RCM) 

RCM JSYS 134 



Returns the word mask of the activated interrupt channels for the 
specified process. (Refer to Section 2.6.1 and the AIC and DIC calls 
for information on activating and deactivating software interrupt 
channels . ) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with 36-bit word in AC1, with bit n on 
meaning channel n is activated 

Generates an illegal instruction interrupt on error conditions below. 
RCM ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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(RCUSR) 



RCUSR 



JSYS 554 



Translates the given user name string to its corresponding 36-bit user 
number. The user name string consists of the user's name without any 
punctuation. The string must be associated with a directory on the 
public structure (usually called PS:) that is not a files-only 
directory. 

Recognition can be used on the string. In addition, the string can 
contain wildcard characters. 



ACCEPTS IN AC1 
AC2 
AC3 



RETURNS 



+ 1 



flag bits in the left half 

byte pointer to ASCII string to be translated 

36-bit user number (given when stepping to the next 
user name in a group) 

always, with 

AC1 containing flag bits in the left half 

AC2 containing an updated byte pointer. If 

recognition was used, this pointer reflects the 

remainder of the string that is appended to the 
original string. 

AC3 containing a 36-bit user number if execution of 
the call was successful. An example of a user 
number is: 500000,, 261. 

The flag bits supplied in the left half of AC1 are as follows. For 
additional information on these bits, refer to the RCDIR monitor call 
description. 

B14(RC%PAR) Allow partial recognition on the user name string. 

B15(RC%STP) Step to the next user name in the group. 

B16(RC%AWL) Allow the user name to contain wildcard characters. 

B17(RC%EMO) Match the given string exactly. 

The flag bits returned in the left half of AC1 are as follows. For 
additional information on these bits, refer to the RCDIR monitor call 
description. 

On success 

B1(RC%ANA) Obsolete 

B2(RC%RLM) User sees all messages from <SYSTEM>MAIL.TXT every time 
he logs in. If this bit is off, the user sees the 
messages only once. 

B6 (RC%WLD) The user name given contained wildcard characters. 
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(RCUSR) 



On failure 

B3 (RC%NOM) 



B4 (RC%AMB) 



B5 (rc%nmd; 



No match was found for the string given. This bit will 
be on if the string given refers to a files-only 
directory, if there is no directory on PS: that is 
associated with the user name string, or bit RC%EMO was 
on in the call and a string was given that matched more 
than one user. 

The string given was ambiguous because it matched more 
than one user . 

There are no more user names in the group, 



The RCDIR monitor call can be used to translate a directory string to 
its corresponding directory number. The DIRST monitor call can be 
used to translate either a user number or a directory number to its 
corresponding string. 

Generates an illegal instruction interrupt on error conditions below. 

RCUSR ERROR MNEMONICS: 



RCUSX1 
RCDIX4 
STRX07 
STRX08 



Insufficient system resources 
Monitor internal error 
Invalid user number 
Invalid user name 
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(RCVIM) 

RCVIM JSYS 751 

Retrieves a message from the ARPANET special message queue. The queue 
must have been previously assigned with the ASNSQ JSYS. 

RESTRICTIONS: for ARPANET systems only. 

ACCEPTS IN AC1: BitO: If set, the user will receive a 96-bit 

leader. If reset, the user will receive 
a 32-bit leader. 
Bitl: If set, the user will receive data in 
the high-order 32 bits of each word of 
the message. If reset, the user will 
receive data in all 36 bits of each word 
of the message. 
Bits 18-35: Special Queue Header 

AC2: Eiddress where extended message is to be stored 

RETURNS +1: failure, error code in AC1 

+2: success, message block stored at address specified in 
AC 2 

The RCVIM JSYS will block until the message is received. 

See SNDIM JSYS for a description of the message format. 

RCVIM ERROR MNEMONICS: 

SQX1: Special network queue handle out of range 

SQX2: Special network queue not assigned 
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TOPS- 20 MONITOR CALLS 
(RCVOK%) 

RCVOK% JSYS 575 



Allows the access-control program (written by the installation) to 
service an approval request in the GETOK% request queue after a user 
program has issued a GETOK% JSYS. 



RESTRICTIONS: 
ACCEPTS IN AC1 
AC2 
RETURNS +1 



Requires WHEEL or OPERATOR capability enabled 
Address of argument block 
Length of argument block 
always 



Argument Block (returned) 



Word Symbol 






.RCFCJ 


1 


.RCUNO 


2 


.RCCDR 


3 


.RCRQN 


4 


.RCNUA 


5 


. RCARA 


6 


.RCCAP 


7 


.RCTER 


10 


.RCRJB 



Contents 



11 



Function code,, job number of requestor 

User number 

Connected directory 

Request number 

# args actually passed to RCVOK% block,, # user args 

supplied in user block 

Address of user arguments 

Capabilities enabled 

Controlling terminal number (not device designator) 

Requested job number 

User arguments 



11+n 

The argument bloc 
section, which 
GETOK% JSYS, and 
arguments the u 
section immediate 
section's length 
access-control pr 
section from wor 
sequence of instr 
argument section 



k returned contains two major segments, the job 
contains information about the job that issued the 

the user argument section, which contains the 
ser supplied with the GETOK% call. The user argument 
ly follows the job section. However, as the job 

may grow with future releases of TOPS-20, the 
ogram should extract the address of the user argument 
d .RCARA of the RCVOK% argument block. The following 
uctions illustrates how to index through the user 
of the RCVOK% argument block: 



LP 



;Build AOBJN pointer 

HLRZ T1,ARGBLK+. RCNUA 

MOVN T1,T1 

HRLZS Tl 

HRR T1,ARGBLK+. RCARA 

MOVE T2, (Tl) 



;Get # user args passed 

;Negate 

;Move to left half-word 

;Get address of user args 

;Get user argument 



AOBJN 



Tl, LP 
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(RCVOK%) 

If the access-control program wishes to reject the requested access, 

the program returns an error code in AC2. It can also provide an 

error string, which is copied to the caller of GETOK% if the caller 
has provided a byte pointer for it. 

Generates an illegal instruction interrupt on error conditions below. 

RCVOK% ERROR MNEMONICS: 

CAPX1: WHEEL or OPERATOR capability required 

G0KER3: JSYS not executed within ACJ fork 
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(RDTTY) 

RDTTY JSYS 523 

Reads input from the primary input designator (.PRIIN) into the 
caller's address space. Input is read until either a break character 
is encountered or the given byte count is exhausted, whichever occurs 
first. Output generated as a result of character editing is output to 
the primary output designator (.PRIOU). 

The RDTTY call handles the following editing functions: 

1. Delete the last character input (DELETE). 

2. Delete back to the last punctuation character (CTRL/W) . 

3. Delete back to the beginning of the current line or, if the 
current line is empty, back to the beginning of the previous 
line (CTRL/U) . 

4. Retype the current line from its beginning or, if the current 
line is empty, retype the previous line (CTRL/R) . 

5. Accept the next character without regard to its usual meaning 
(CTRL/V) . 

By handling these functions, the RDTTY call serves as an interface 
between the terminal and the user program. 

ACCEPTS IN AC1: byte pointer to string in caller's address space 
where input is to be placed 

AC2: B0(RD%BRK) Break on CTRL/Z or ESC. 

B1(RD%T0P) Break on CTRL/G, CTRL/L, CTRL/Z, ESC, 

carriage return, line feed. 
B2(RD%PUN) Break on punctuation (see below). 
B3 (RD%BEL) Break on end of line (carriage return and 

line feed, or line feed only). 
B4 (RD%CRF) Suppress a carriage return and return a 

line feed only. 
B5 (RD%RND) Return to user program if user tries to 

delete beyond beginning of the input 

buffer (e.g., user types a CTRL/U or 

DELETE past the first character in the 

buffer) . If this bit is not set., the 

call rings the terminal's bell and waits 

for more input. 
B7(RD%RIE) Return to user program if input buffer is 

empty. If this bit is not set, the call 

waits for more input. 
B9(RD%BEG) Return to the user program if the user 

attempts to edit beyond the beginning of 

the input buffer. 
B10(RD%RAI) Convert lowercase input to uppercase 

input . 
B11(RD%SUI) Suppress CTRL/U indication (i.e., do not 

print XXX, and on display terminals, do 

not delete the characters from the 

screen) . 
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RETURNS 



B18-B35 Number of bytes available in the string. 
The input is terminated when this count 
is exhausted, even if the specified break 
character has not yet been typed. 

If the left half of AC2 is 0, the input is terminated 
on end of line only. 
AC3: byte pointer to prompting-text (CTRL/R buffer), or 
if no text. This text, followed by any text in the 
input buffer, is output if the user types CTRL/R in 
his first line of input. If no CTRL/R text exists or 
the user types CTRL/R on other than the first line of 
input, only the text on the current line will be 
output. 

+1: failure, error code in AC1 

+2: success, updated byte pointer in AC1, appropriate 
bits set in the left half of AC2, and updated count 
of available bytes in the right half of AC2 



The bits returned in the left half of AC2 on a successful return are: 

B12(RD%BTM) Break character terminated the input. If 
this bit is not set, the input was 
terminated because the byte count was 
exhausted . 

B13(RD%BFE) Control was returned to the program 
because the user tried to delete beyond 
the beginning of the input buffer and 
RD%RND was on in the call. 

B14(RD%BLR) The backup limit for editing was reached. 



NOTE 

Bits not described are reserved 
for use by the monitor. The 
state of these bits on completion 
of the RDTTY call is undefined. 



The punctuation break character set (RD%PUN) is as follows 



CTRL/A-CTRL/F 

CTRL/H-CTRL/I 

CTRL/K 

CTRL/N-CTRL/Q 

CTRL/S-CTRL/T 

CTRL/X-CTRL/Y 



ASCII codes 34-36 

ASCII codes 40-57 

ASCII codes 72-100 

ASCII codes 133-140 

ASCII codes 173-176 
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Upon completion of the call, the terminating character is stored in 
the string, followed by a NULL (unless the byte count was exhausted). 
Also, any CTRL/V, along with the character following it, is stored in 
the string. 

RDTTY ERROR MNEMONICS: 



RDTX1 
10X11 
10X34 
10X35 



Invalid string pointer 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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(RELD) 

RELD JSYS 71 

Releases one or all devices assigned to the job. When a device is 
released by the job, the resource allocator receives an IPCF packet. 
(Refer to the ALLOC monitor call description for the format of the 
packet sent to the allocator.) 

ACCEPTS IN AC1: device designator, or -1 to release all devices 
assigned to this job 

RETURNS +1: failure, error code in AC1 

+2: success 

The ASND monitor call can be used to assign a device to the caller. 

If this JSYS is issued for a device on which the user has an open JFN, 
an error will be returned. 

RELD ERROR MNEMONICS: 



DEVX1 
DEVX2 
DEVX6 



Invalid device designator 

Device already assigned to another job 

Job has open JFN on device 
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(RELSQ) 

RELSQ JSYS 753 

Deassigns the ARPANET special message queue. (The LGOUT JSYS 
deassigns all special message queues.) All pending messages relative 
to the specified queue(s) are discarded. 

RESTRICTIONS: for ARPANET systems only. 

ACCEPTS IN AC1: special queue handle (returned by ASNSQ) , or -1 to 
deassign all special queues. 

RETURNS +1: always 

RELSQ functions as a no-op if an unassigned queue is specified in AC1. 
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(RESET) 

RESET JSYS 147 

Resets and initializes the current process. It is a good programming 
practice to include this call at the beginning of each assembly 
language program. 

RETURNS +1: always 

The RESET monitor call performs the following: 

1. Closes all files at or below the current process and releases 
all JFNs. If a file is nonexistent (i.e., has never been 
closed), it is closed and then expunged. 

2. Kills all inferior processes. 

3. Clears the current process 1 software interrupt system. The 
channel table and priority level table addresses remain 
unchanged from any previous settings. 

4. Sets the following fields of the controlling terminal's JFN 
mode word (refer to Section 2.4.9.1): 

TT%WAK (B18-B23) to wake up on every character 
TT%ECO(B24) to cause echoing 

.TTASI(B29) to translate both echo and output (ASCII data 
mode) 

Remaining fields of the mode word are not changed. 

5. Releases all of the current process' PIDs. 

6. Dequeues all of the current process 1 ENQ requests. 

7. Clears the compatibility package's entry vector. 

8. Releases all process handles that can be released. (Refer to 
the RFRKH call description.) 
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(RFACS) 

RFACS JSYS 1.61 



Returns the ACs of the specified process. 

ACCEPTS IN AC1: process handle 

AC2: address of the beginning of a 20-word (octal) table 
in the caller's address space where the AC values of 
the specified process are to be stored 



RETURNS 



+1 : always 



The SFACS monitor call can be used to set the ACs for a specified 
process . 

Generates an illegal instruction interrupt on error conditions below. 

RFACS ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX4 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Process is running 

Illegal to manipulate an execute-only process 
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(RFBSZ) 

RFBSZ JSYS 45 



Returns the byte size for a specific opening of a file. (Refer to the 
OPENF or SFBSZ call description for setting the byte size.) 



ACCEPTS IN AC1 

RETURNS +1 

+ 2 



JFN 

failure, error code in AC1 

success, byte size right-justified in AC2 



RFBSZ ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 
DESX5 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 
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(RFCOC) 

RFCOC JSYS 112 

Returns the control character output control (CCOC) words for the 
specified terminal. (Refer to Section 2.4.9.2.) 

ACCEPTS IN AC1: file designator 

RETURNS +1: always, with output control words in AC2 and AC3 

The CCOC words consist of 2-bit bytes, each byte representing the 
output control for one of the ASCII codes 0-37. If the given 
designator is not associated with a terminal, the CCOC words are 
returned in AC2 and AC3 with each 2-bit byte containing a value of 2 
(send actual code and account format action) . 

The SFCOC monitor call can be used to set the CCOC words for a 
specified terminal. 

Generates an illegal instruction interrupt on error conditions below. 

RFCOC ERROR MNEMONICS: 

TTYX01: Line is not active 
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(RFMOD) 



RFMOD JSYS 107 



Returns the JFN mode word associated with the specified file. (Refer 
to Section 2.4.9,1.) The MTOPR monitor call should be used to return 
the page length and width fields, especially when the fields have 
values greater than 127. The RFMOD call returns these fields as 1 
when their values are greater than 127. 

ACCEPTS IN AC1: source designator 

RETURNS +1: always, with mode word in AC2 

If the designator is not a terminal, the RFMOD call returns in AC2 a 
word in the following format 

7B3 + ~D66B10 + /V D72B17+ 4 mode bits from the OPENF for the designator 

This setting of the left half of AC2 indicates that the designator has 
mechanical form feed, mechanical tab, lower case, page length of 66, 
and page width of 72. 

The SFMOD and STPAR monitor calls can be used to set various fields of 
the JFN mode word. 

RFMOD ERROR MNEMONICS: 
TTYX01: Line is not active 
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(RFORK) 

RFORK JSYS 155 



Resumes one or more processes that had been directly frozen. This 
monitor call does not resume a process that has been indirectly 
frozen. (Refer to Section 2.7.3.1.) Also, the RFORK call cannot be 
used to resume a process that is suspended because of a monitor call 
intercept. (Refer to the UTFRK call.) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always 

The RFORK monitor call is a no-op if the referenced process (s) was not 
directly frozen. 

The FFORK monitor call can be used to freeze one or more processes. 

Generates an illegal instruction interrupt on error conditions below. 

RFORK ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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(RFPOS) 

RFPOS JSYS 111 



Returns the current position of the specified terminal's pointer. 
(Refer to Section 2.4.9.1 for information on page lengths and widths 
of terminals.) 

ACCEPTS IN AC1: device designator 

RETURNS +1: always, with AC2 contains position within a page 
(i.e., line number) in the left half, and position 
within a line (i.e., column number) in the right half 

AC2 contains if the designator is not associated with a terminal. 

The SFPOS monitor call can be used to set the position of the 
terminal's pointer. 

Generates an illegal instruction interrupt on error conditions below. 

RFPOS ERROR MNEMONICS: 



DESX1 
DESX3 
DESX5 
DEVX2 
TTYX01 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

Device already assigned to another job 

Line is not active 
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(RFPTR) 

RFPTR JSYS 43 



Returns the current position of the specified file's pointer. 



ACCEPTS IN AC1 

RETURNS +1 

+ 2 



JFN 

failure, error code in AC1 

success, byte number in AC2 



The SFPTR monitor call can be used to set the position of the file's 
pointer . 

RFPTR ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 
DESX5 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 



3-344 



TOPS-20 MONITOR CALLS 
(RFRKH) 

RFRKH JSYS 165 

Releases the specified handle of a process. A handle can be released 
only if it describes either an existent process inferior to at least 
one other process in the job or a process that has been killed via 
KFORK (i.e., a nonexistent process). 

ACCEPTS IN AC1: process handle, or -1 to release all relative handles 
that can be released 

RETURNS +1: failure, error code in AC1 

+2: success 

The process handles released when AC1 is -1 are the ones released on a 
RESET or a KFORK monitor call. 

RFRKH ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(RFSTS) 

RFSTS JSYS 156 

Returns the status of the specified process. 

SHORT FORM: 

ACCEPTS IN AC1: 0,, process handle 

RETURNS +1: always, with the status word in AC1 and the PC in AC2 

Flags : 

B0-B17 Unused, must be zero. 

The process status word has the following format: 

B0(RF%FRZ) The process is frozen. If this bit is off, 

the process is not frozen. 

B1-B17 (RF%STS) The status code for the process. The 

following values are possible: 

Meaning 

The process is runnable. 

The process is dismissed 
for I/O. 

The process is dismissed 
by voluntary process 
termination (HFORK or 
HALTF) or was never 
started . 

.RFFPT The process is dismissed 
by forced process 
termination. Forced 
termination occurs when 
bit 17(SC%FRZ) of the 
process capability word 
is not set. 

. RFWAT The process is dismissed 
waiting for another 
process to terminate. 

.RFSLP The process is dismissed 
for a specified amount of 
time . 

. RFTRP The process is dismissed 
because it attempted to 
execute a call on which 
an intercept has been set 
by its superior (via the 
TFORK call) .. 



lue 


Symbol 





.RFRUN 


1 


.RFIO 


2 


.RFHLT 
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(RFSTS) 

Value Symbol Meaning 

7 .RFABK The process is dismissed 

because it encountered an 
instruction on which an 
address break was set (by 
means of the ADBRK call) . 

B18-B35 (RF%SIC) The number of the software interrupt channel 

that caused the forced process termination. 

The RFSTS call returns with -1 (fullword) in AC3 if the specified 
handle is assigned but refers to a deleted process. The call 
generates an illegal instruction interrupt if the handle is 
unassigned . 

LONG FORM: 

ACCEPTS IN AC1: f lags ,, process handle 

AC2: address of status return block (used for long form 
only) 

RETURNS +1: always 

Flags: 

BO RF%LNG Long form call (must be on) 

B1-B17 Unused, must be zero. 

In the long form call, RF%LNG is set in AC1 and AC2 contains the 
address of a status-return block. On the return, AC1 and AC2 are not 
modified. The status-return block has the following format: 

Word Symbol Meaning 

. RFCNT Count of words returned in this block in the left 

half, and count of maximum number of words to 
return in right half (including this word). The 
right half of this word is specified by the user. 

1 . RFPSW Process status word. This word has the same 

format as AC1 on a return from a short call. If a 
valid, but unassigned, process handle was 
specified in AC1, then this word contains -1 and 
no other words are returned. 

2 .RFPFL Process PC flags. These are the same flags 

returned in AC2 on a short call. 

3 .RFPPC Process PC. This is the address; no flags are 

returned in this word. 

4 .RFSFL Status flag word. 

Flags : 

Bit Symbol Meaning 

BO RF%EXO Process is execute-only 
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Generates an illegal instruction interrupt on error conditions below, 
RFSTS ERROR MNEMONICS: 



DECRSV 
FRKHX1 
FRKHX2 
FRKHX3 



DEC-reserved bits not zero 

Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(RFTAD) 

RFTAD JSYS 533 

Returns the dates and times associated with the specified file. 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



source designator 

address of argument block 

length of argument block 

always, with dates returned in the argument block 



The format of the argument block is as follows 



Word 


Symbol 





.RSWRT 


1 


.RSCRV 


2 


.RSREF 


3 


.RSCRE 



.RSTDT 



.RSNET 



.RSFET 



Meaning 

Internal date and time file was last written. 

Internal date and time file was created. 

Internal date and time file was last referenced. 

System date and time of last write by the monitor. 
(The COPY and RENAME commands in the EXEC change 
this word, for example.) Requires WHEEL or 
OPERATOR capability enabled. 

Tape-write date and time for archived or migrated 
files. 

Online expiration date and time. May be a date 
and time (in internal format) or an interval (in 
days). Intervals are limited to half-word values. 

Offline expiration date and time. May be a date 
and time (in internal format) or an interval (in 
days). Intervals are limited to half-word values. 



On a successful return, the values for the number of words specified 
in AC3 are returned in the argument block. Words in the argument 
block contain -1 if any one of the following occurs: 

1. The corresponding date does not exist for the file. 

2. The designator is not associated with a file. 

3. The corresponding date is not currently assigned (i.e., the 
argument block contains more than 4 words) . 
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(RFTAD) 

The following table illustrates which JSYS ' s set the file dates and 
times : 

Word GTJFN OPENF OPENF CLOSF SFTAD RNAMF ARCF 



.RSWRT 

.RSCRV 

.RSREF 

.RSCRE 

.RSTDT - Set* FDB Set* 

.RSNET 

.RSFET 

LEGEND: 

* Requires WHEEL or OPERATOR capability enabled. 

FDB This word copied from source FDB to destination FDB. 

Generates an illegal instruction interrupt on error conditions below. 

RFTAD ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX7: Illegal use of parse-only JFN or output wildcard-designators 



TJFN 


OPENF 


OPENF 


CLOSF 


SFTAD 


RNAM 




Read 


Wr i te 


Wr ite 






- 


- 


Set 


- 


Set 


FDB 


Set 


- 


- 


- 


Set 


FDB 


- 


Set 


- 


- 


Set 


Set 


Set 


- 


- 


Set 


Set* 


FDB 


- 


- 


- 


- 


Set* 


FDB 


- 


- 


- 


- 


Set 


FDB 


- 


- 


- 


- 


Set 


FDB 
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RIN 



JSYS 54 



Inputs a byte nonsequentially (i.e., random byte input) from the 
specified file. The size of the byte is that given in the OPENF call. 
The RIN call can be used only when reading data from disk files. 



ACCEPTS IN AC1 

AC3 

RETURNS +1 



JFN 

byte number within the file 

always, with the byte right-justified in AC2 



If the end of the file is reached, AC2 contains 0. The program can 
process this end-of-file condition if an ERJMP or ERCAL is the next 
instruction following the RIN call. Upon successful execution of the 
call, the file's pointer is updated for subsequent I/O to the file. 

The ROUT monitor call can be used to output a byte nonsequentially to 
a specified file. 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 

RIN ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX4 

DESX5 

IOX1 

IOX3 

IOX4 

10X5 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 

File is not open for reading 

Illegal to change pointer for this opening of file 

End of file reached 

Device or data error 
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(RIR) 



RIR 



JSYS 144 



Returns the channel and priority level table addresses for the 
specified process. (Refer to Section 2.6.3.) These table addresses 
are set by the SIR monitor call. The process must run in one section 
of memory. To obtain the addresses of the channel and priority tables 
for a process that runs in multiple sections, use the XRIR% monitor 
call. (See also the XSIR% monitor call. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with the priority level table address in the 
left half of AC2, and the channel table address in 
the right half of AC2 

AC2 contains if the SIR monitor call has not been executed by the 
designated process. 

Generates an illegal instruction interrupt on error conditions below. 

RIR ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 



TOPS-20 Version 5 



3-352 



April 1982 



TOPS- 20 MONITOR CALLS 
(RIRCM) 

RIRCM JSYS 143 

Returns the mask for reserved software interrupt channels for the 
specified process. A process is able to read its own or its 
inferiors' channel masks. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with the reserved channel mask for the 
specified process in AC2 

The SIRCM monitor call can be used to set the mask for reserved 
software interrupt channels. 

Generates an illegal instruction interrupt on error conditions below. 

RIRCM ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(RLJFN) 

RLJFN JSYS 23 

Releases the specified JFNs. A JFN cannot be released unless it 
either has never been opened or has already been closed. Also, a JFN 
cannot be released if it is currently being assigned by a process, 
unless that process is the same as the one executing the RLJFN and is 
not at interrupt level. The GS%ASG bit returned from a GTSTS call for 
the JFN indicates if the JFN is currently being assigned. 

ACCEPTS IN AC1: JFN, or -1 to release all JFNs created by this 
process or its inferiors that do not specify open 
files 

RETURNS +1: failure, error code in AC1 

+2: success 

RLJFN ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

RJFNX1: File is not closed 

RJFNX2: JFN is being used to accumulate filename 

RJFNX3: JFN is not accessible by this process 

OPNX1: File is already open 
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(RMAP) 

RMAP JSYS 61 

Acquires a handle on a page in a process to determine the access 
allowed for that page. 

ACCEPTS IN AC1: process handle in the left half, and a page number 
within the process in the right half 

RETURNS +1: always, with a handle on the page in AC1, and access 
information in AC2. The handle in AC1 is a 
process/file designator in the left half and a page 
number in the right half. This is called a page 
handle. 

The access information returned in AC2 is as follows: 

B2(RM%RD) read access allowed 

B3(RM%WR) write access allowed 

B4 (RM%EX) execute access allowed 

B5(RM%PEX) page exists 

B9 (RM%CPY) copy-on-wr ite access 

If the page supplied in the call does not exist, RMAP returns a -1 in 
AC1 and a zero in AC2. 

Generates an illegal instruction interrupt on error conditions below. 

RMAP ERROR MNEMONICS: 

FRKHX1: Invalid process handle 
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(RNAMF) 

RNAMF JSYS 35 

Renames an existing file. The JFNs of both the existing file and the 
new file specification must be closed. 

ACCEPTS IN AC1: JFN of existing file to be renamed (i.e., source 
file) 

AC2: JFN of new file specification (i.e., destination file 
specification) 

RETURNS +1: failure, error code in AC1 

+2: success, JFN in AC1 is released, and the JFN in AC2 
is associated with the file under its new file 
specification 

If the JFN of the new file specification already refers to an existing 
file, the existing file's contents are expunged. 

When a file is renamed, many of the attributes of the existing file 
are given to the renamed file. The settings of the following words in 
the FDB (refer to Section 2.2.8) are copied from the existing file to 
the renamed file. 

Word .FBCTL (FB%LNG, FB%DIR, FB%NOD, FB%BAT, FB%FCF) 

Word .FBADR 

Word .FBCRE 

Word .FBGEN (FB%DRN) 

Word .FBBYV (FB%BSZ, FB%MOD, FB%PGC) 

Word .FBSIZ 

Word .FBCRV 

Word . FBWRT 

Word .FBREF 

Word .FBCNT 

Word .FBUSW 

Note that the setting of FB%PRM (permanent file) does not get copied. 
Thus, if a file with bit FB%PRM on is renamed, the renamed file has 
FB%PRM off. The existing file is left in a deleted state with its 
contents empty but its FDB existent. 

Renaming a file with tape information (an archived or migrated file) 
carries the tape information to the new file name. Renames which 
would effectively destroy a file with archive status will fail. 

RNAMF ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX7: Illegal use of parse-only JFN or output wildcard-designators 

OPNXl: File is already open 

RNAMX1: Files are not on same device 

RNAMX2: Destination file expunged 
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RNAMX3: Write or owner .access to destination file required 

RNAMX4: Quota exceeded in destination of rename 

RNAMX5: Destination file is not closed 

RNAMX6: Destination file has bad page table 

RNAMX7: Source file expunged 

RNAMX8: Write or owner access to source file required 

RNAMX9 : Source file is nonexistent 

RNMX10: Source file is not closed 

RNMX11: Source file has bad page table 

RNMX12: Illegal to rename to self 

RNMX13: Insufficient system resources 
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TOPS-20 MONITOR CALLS 
(ROUT) 

ROUT JSYS 55 



Outputs a byte nonsequent ially (i.e., random byte output) to the 
specified file. The size of the byte is that given in the OPENF call 
for the JFN. The ROUT call can be used only when writing data to disk 
files . 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



JFN 

the byte to be output, right-justified 

the byte number within the file 

always 



Upon successful execution of the call, the file's pointer is updated 
for subsequent I/O to the file. 

The RIN monitor call can be used to input a byte nonsequent ially from 
a specified file. 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description . ) 

ROUT ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX5: File is not open 

IOX2: File is not opened for writing 

10X3: Illegal to change pointer for this opening of file 

10X5: Device or data error 

10X6: Illegal to write beyond absolute end of file 

10X11: Quota exceeded 

10X34: Disk full 

10X35: Unable to allocate disk - structure damaged 
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(RPACS) 

RPACS JSYS 57 



Returns the accessibility of a page. 
ACCEPTS IN AC1 



Process/file designator in the left half, and page 
number within the process or file in the right half 



RETURNS 



+ 1 



Always, with AC2 containing 
information: 



the 



following 



B2(PA%RD) read access allowed 

B3(PA%WT) write access allowed 

B4(PA%EX) execute access allowed 

B5(PA%PEX) page exists 

B6(PA%IND) indirect pointer 

B9(PA%CPY) copy-on-write 

B10(PA%PRV) private page 

B20(P1%RD) read access allowed in first pointer 

B21(P1%WT) write access allowed in first pointer 

B22(P1%EX) execute access allowed in first pointer 

B23(P1%PEX) page exists in first pointer 

B27(P1%CPY) copy-on-write in first pointer 

The bits in the left half are the result of tracing any indirect 
pointer chains, and the bits in the right half contain information 
about the first pointer (the one in the map directly indicated by the 
argument) only. 

The left half and right half information will be different only if an 
indirect pointer was encountered in the first map. In this case, 
B6(PA%IND) is set, the left half access is less than or equal to the 
right half access; and B9 (PA%CPY) is set if it was found set at any 
level . 

The bits B5(PA%PEX) and B10(PA%PRV) always refer to the last pointer 
(first nonindirect pointer) encountered. 

The SPACS monitor call can be used to set the accessibility of a page. 

Generates an illegal instruction interrupt on error conditions below. 

RPACS ERROR MNEMONICS: 

ARGX06: Invalid page number 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX5: File is not open 

DESX8: File is not on disk 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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(RPCAP) 

RPCAP JSYS 150 

Returns the capabilities for the specified process. (Refer to Section 
2.7.1 for the description of the capability word.) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with capabilities possible for this process 
in AC2, and capabilities enabled for this process in 
AC3 

The EPCAP monitor call can be used to enable the capabilities of a 
process . 

Generates an illegal instruction interrupt on error conditions below. 

RPCAP ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX3: Invalid use of multiple process handle 
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(RSCAN) 

RSCAN JSYS 500 

Places a text string in, or reads a text string from, the job's rescan 
buffer (an area of storage in the Job Storage Block). This facility 
allows a program to receive information that will be used as primary 
input for another program before this other program reads input from 
the terminal . 

The RSCAN call has two steps: the acceptance and the use of the text 

string. Each step has a different calling sequence. The first step 

is to accept the text string to be used as input and to place this 

string in the rescan buffer. The calling sequence for this step 

specifies, in AC1, a pointer to the text string to be input. Note 

that the string stored in the rescan buffer is terminated by a null 
byte. 

The second step is to make the string available to the program, which 
can read the string by means of the BIN call. The calling sequence 
for this second step specifies a function code of O(.RSINI) in AC1. 
This code indicates that the last string entered at command level from 
the terminal is available for reading. 

The program executing the RSCAN call can determine when the data has 
been read by issuing the function code l(.RSCNT), which returns the 
number of characters remaining in the buffer. 

In other words, the first RSCAN call, specifying a new text string, 
stores the string in the rescan buffer, but does not cause it to be 
read. A second RSCAN call must be given before the string can be 
read . 

This second RSCAN causes the system to provide input from the most 
recent string stored, and can be given only once. After this second 
RSCAN call, nothing will be read from the rescan buffer until another 
RSCAN call specifies a different text string. In addition, the job 
receives input from the rescan buffer only if the source for input in 
the BIN call is the JFN of the controlling terminal. If the source 
for input is other than the controlling terminal, input will not come 
from the rescan buffer. 

ACCEPTS IN AC1: byte pointer to a new text string, or in the left 
half and function code in the right half 

RETURNS +1: failure, error code in AC1 

+2: success 

The defined functions are as follows: 

Function Symbol Meaning 

.RSINI Make the data in the buffer available as 

input to any process in the current job that 
is reading data from its controlling 
terminal . 

1 .RSCNT Return the number of characters remaining to 

be read in the buffer. This function does 
not cause data to be read; it is used to 
determine when all the data has been read 
after making the data available. 
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On a successful return, AC1 contains an updated byte pointer if a 

pointer was given in the call. Otherwise, AC1 contains either the 

number of characters in the rescan buffer, or if there are no 
characters. 

To clear the RSCAN buffer, supply a byte pointer (in AC1) to a null 
str ing . 

RSCAN ERROR MNEMONICS: 

RSCNX2: Invalid function code 
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RSMAP% JSYS 610 

Reads a section map, and provides information about the mapping of one 
section of a fork's memory. 

ACCEPTS IN AC1: fork handle ,, sect ion number 

RETURNS +1: Always, with map information in AC1 and access 
information in AC2 

The map information returned in AC1 can be the following: 

-1 no current mapping present 

the mapping is a private section 

n,,m where n is a fork handle or a JFN, and m is a 

section number. If n is a fork handle, the 
mapping is an indirect or shared mapping to 
another fork's section. If n is a JFN, the 
mapping is a shared mapping to a file section. 
These are called section handles. 

The access information bits returned in AC2 are the following: 

B2(SM%RD) Read access is allowed 

B3(SM%WR) Write access is allowed 

B4(SM%EX) Execute access is allowed 

B5(PA%PEX) The section exists 

B6(SM%IND) The section was created using an indirect pointer. 
Generates an illegal instruction interrupt on error conditions below. 
RSMAP% ERROR MNEMONICS: 
ARGX23: Invalid section number 
ARGX28: Not. available on this system 
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RTFRK JSYS 322 

Returns the handle of the process that was suspended because of a 
monitor call intercept and the monitor call that the process was 
attempting to execute. The superior process monitoring the intercepts 
can receive only one interrupt at a time. Thus, the superior process 
should execute the RTFRK call after receiving an interrupt to identify 
the process that caused the interrupt. 

The system maintains a queue of the processes that have been suspended 
and that are waiting to interrupt the superior process monitoring the 
intercepts. The RTFRK call advances the processes on the queue; and 
if the call is not executed, subsequent interrupts are not generated. 

See the description of the TFORK JSYS for more information on the 
monitor call intercept facility. 

RETURNS +1: always, with AC1 containing the handle of the process 
that generated the interrupt, and AC2 containing the 
monitor call instruction that caused the process to 
be suspended. If no process is currently suspended 
because of a monitor call intercept, AC1 and AC2 
contain on return. 

Because the process handle returned in AC1 is a relative process 
handle, it is possible that a process is currently suspended, but that 
all relative handles are in use. In this case, the caller should 
release a relative process handle with the RFRKH call and then reissue 
the RTFRK call. 

Generates an illegal instruction interrupt on error conditions below. 

RTFRK ERROR MNEMONICS: 

FRKHX6: All relative process handles in use 



3-364 



TOPS-20 MONITOR CALLS 
(RTIW) 

RTIW JSYS 173 



Reads the terminal interrupt word (refer to Section 2.6.6) for the 
specified process or the entire job, and returns the terminal 
interrupt word mask. 

ACCEPTS IN AC1: BO (RT%DIM) return the mask for deferred terminal 

interrupts 



B18-B35 
(RT%PRH' 



process handle, or -5 for entire job 



RETURNS 



+1: always, with the terminal interrupt mask in AC2, and 
the deferred terminal interrupt mask in AC3. The 
deferred interrupt mask is returned only if both 
B0(RT%DIM) is on and the right half of AC1 indicates 
a specific process. 

The STIW monitor call can be used to set the terminal interrupt word 
masks . 

Generates an illegal instruction interrupt on error conditions below. 

RTIW ERROR MNEMONICS: 



FRKHXl 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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(RUNTM) 

RUNTM JSYS 15 

Returns the run time of the specified process or of the entire job. 

ACCEPTS IN AC1: process handle, or . FHJOB (-5) for the entire job 

RETURNS +1: always, with runtime (in milliseconds) 
right-justified in AC1, a divisor to convert time to 
seconds in AC2, and console time (in milliseconds) in 
AC3. AC2 always contains 1000; thus, it is not 
necessary to examine its contents. 

Generates an illegal instruction interrupt on error conditions below. 

RUNTM ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

RUNTX1: Invalid process handle -3 or -4 
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TOPS-20 MONITOR CALLS 
(RWM) 

RWM JSYS 135 

Returns the word mask for the interrupts waiting on software channels 
for the specified process. 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with 

AC1 containing a 36-bit word with bit n on, meaning 
that an interrupt on channel n is waiting. 

AC2 containing the status of the interrupts in 
progress. Bit n on in the left half means an 
interrupt of priority level n occurring during 
execution of user code is in progress. Bit 18+n 
on in the right half means an interrupt of 
priority level n occurring during execution of 
monitor code is in progress. 

Generates an illegal instruction interrupt on error conditions below. 

RWM ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(RWSET) 

RWSET JSYS 176 

Releases the working set by removing all of the current process' pages 
from its working set. The pages are moved to secondary storage and 
are not preloaded the next time the process is swapped in. This 
operation is invisible to the user. 

RETURNS +1: always 
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TOPS- 20 MONITOR CALLS 
(SACTF) 

SACTF JSYS 62 



Sets the account to which the specified file is to be charged. 

RESTRICTIONS: When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

ACCEPTS IN AC1: J FN 

AC2: account number in bits 3-35 if bits 0-2 contain 5. 

Otherwise, contains a byte pointer to an account 

string in the address space of caller. If a null 

byte is not seen, the string is terminated after 39 
characters are processed. 

RETURNS +1: failure, error code in AC1 

+2: success, updated string pointer in AC2 

If the account validation facility is enabled, the SACTF call verifies 
the account given and returns an error if it is not valid for the 
caller . 

The GACTF monitor call can be used to obtain the account designator to 
which a file is being charged. 

SACTF ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

SACTX1: File is not on multiple-directory device 

SACTX2: Insufficient system resources (Job Storage Block full) 

SACTX3: Directory requires numeric account 

SACTX4: Write or owner access required 

VACCXO: Invalid account 

VACCX1: Account string exceeds 39 characters 

VACCX2: Account has expired 
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TOPS-20 MONITOR CALLS 
(SAVE) 

SAVE JSYS 202 



Saves, in nonsharable format, pages of a process in the specified 

file. The process must run in one section of memory. (Refer to 

Section 2.8.1 for the format of a nonsharable save file. See the 

SSAVE monitor call for saving processes in sharable format.) This file 

can then be copied into a given process with the GET monitor call. 

ACCEPTS IN AC1: process handle in the left half, and J FN in the right 
half 

AC2: one table entry, or in the left half and pointer to 
the table in the right half (see below) 



RETURNS 



+1: always 



The table has words in the format: length of the area to save in the 
left half and address of the first word to save in the right half. 
The table is terminated by a word. 

Nonexistent pages are not saved. The SAVE call also does not save the 
accumulators. Thus, it is possible to save all assigned nonzero 
memory in section zero or the current section with the table entry 
777760, ,20 in AC2. 

The SAVE call does not save section numbers as parts of addresses, so 
all addresses are section-relative. Furthermore, the SAVE call saves 
only the section in which the call is executed. 

The SAVE call closes and releases the given JFN. 

Can cause several software interrupts or process terminations on 
certain file conditions. 

Generates an illegal instruction interrupt on error conditions below. 

SAVE ERROR MNEMONICS: 



FRKHX1 

FRKHX2 

FRKHX3 

FRKHX8 

SAVX1 

10X11 

10X34 

10X35 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 

Illegal to save files on this device 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 



All file errors can also occur. 
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TOPS-20 MONITOR CALLS 
(SCTTY) 

SCTTY JSYS 324 

Redefines the controlling terminal for the specified process and all 
of its inferiors. The controlling terminal can be redefined at any 
level in the job's process structure; inferior processes below this 
level uses this terminal by default as their controlling terminal. 
Therefore, the controlling terminal of a process is defined to be: 

1. The one that has been explicitly defined for it by a SCTTY 
call. 

2. If no terminal has been explicitly defined for the process, 
the terminal that has been explicitly defined for its closest 
superior by a SCTTY call. 

3. If no SCTTY call has been executed for a superior process, 
the job's controlling terminal. 

The effect of terminal interrupts on a process is dictated by the 
controlling terminal for the process. This means that processes that 
have enabled specific terminal characters receives an interrupt when 
those characters are typed on the controlling terminal. If no SCTTY 
call has been executed for any process in the job, the controlling 
terminal for all processes within the job is the job's controlling 
terminal. (The job's controlling terminal is usually the one used to 
log in and control the job.) In addition to being the source of all 
terminal interrupts, the job's controlling terminal serves as the 
primary I/O designators (refer to Section 1.2.6) for all processes in 
the job, unless these designators have been changed for a process. 

When a SCTTY call is executed for a process within a job, the 
controlling terminal and the source of terminal interrupts are changed 
for that process and all of its inferiors. This group of processes 
receives interrupts only from the new controlling terminal and no 
longer from the job's controlling terminal. These processes cannot 
receive or change terminal interrupts from any other controlling 
terminals. However, primary I/O continues to be received from and 
sent to the job's controlling terminal if the primary I/O designators 
have not been changed. For most applications, the primary I/O 
designators should be changed with the SPJFN call to correspond to the 
new controlling terminal. 

ACCEPTS IN AC1: function code in the left half, and process handle in 
the right half 

AC2: terminal designator 

RETURNS +1: always 
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TOPS-20 MONITOR CALLS 
(SCTTY) 



The available functions are as follows: 
Code Symbol 



Meaning 



.SCRET Return the designator of the given process 1 

controlling terminal. The designator is 
returned in AC2. 

1 .SCSET Change the given process' controlling 

terminal to the terminal designated in AC2. 
The terminal designator cannot refer to the 
job's controlling terminal. This function 
also changes the controlling terminal of all 
processes inferior to the given process. 

2 .SCRST Reset the given process' controlling terminal 

to the job's controlling terminal. This 

function also resets the controlling terminal 

of all processes inferior to the given 
process . 

Functions .SCSET and .SCRST require the process to have the SC%SCT 
capability (refer to Section 2.7.1) enabled in its capability word. 

The SCTTY monitor call cannot be used to change the controlling 
terminal for the current process or for any process superior to the 
current process. 

Generates an illegal instruction interrupt on error conditions below. 

SCTTY ERROR MNEMONICS: 



SCTX1 

SCTX2 

SCTX3 

SCTX4 

FRKHX1 

FRKHX2 

DESX1: 

DEVX2: 



Invalid function code 

Terminal already in use as controlling terminal 

Illegal to redefine the job's controlling terminal 

SC%SCT capability required 

Invalid process handle 

Illegal to manipulate a superior process 

Invalid source/destination designator 

Device already assigned to another job 
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TOPS-20 MONITOR CALLS 
(SCVEC) 

SCVEC JSYS 301 

Sets the entry vector and the UUO locations for the compatibility 
package . 

ACCEPTS IN AC1: process handle 

AC2: entry vector length in the left half, and entry 
vector address in the right half 

AC3: UUO location in the left half, and PC location in the 
right half 

RETURNS +1: always 

The compatibility package's entry vector is as follows: 

Meaning 

Entry address for interpreting UUOs 

Initial entry for setup and first UUO 

Entry for GET share file routine (obsolete) 

Address to receive contents of location 40 on 
the UUO call 

Address to receive the return PC word on the 
UUO call 

Entry for MAKE share file routine (obsolete) 

Communication for handling CTRL/C , START 
sequences between the compatibility package 
and the TOPS-20 Command Language 

The monitor transfers to the address specified in the right half of 
AC2 on any monitor call whose operation code is 040-077 (a monitor 
UUO) . This transfer occurs after the monitor stores the contents of 
location 40 and the return PC in the locations specified by the left 
half and right half of AC3, respectively. The entry vector is 
retained but is not used by the monitor. 

If AC2 is 0, the next UUO causes the compatibility package to be 
merged into the caller's address space. In this case, the UUO and PC 
locations are set from words 3 and 4, respectively, of the 
compatibility package's entry vector. 

If AC2 is -1, UUO simulation is disabled, and an occurrence of a UUO 
is considered an illegal instruction. This action is useful when the 
user is removing UUOs from a program. 

The GCVEC monitor call can be used to obtain the entry vector for the 
compatibility package. 



Word 


Symbol 





. SVEAD 


1 


.SVINE 


2 


.SVGET 


3 


.SV40 


4 


.SVRPC 


5 


. SVMAK 


6 and 7 


.SVC ST 
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TOPS-20 MONITOR CALLS 
(SCVEC) 



SCVEC ERROR MNEMONICS 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX4 
FRKHX8 



Invalid process handle 

Illegal to manipulate superior process 

Invalid use of multiple process handle 

Process is running 

Illegal to manipulate an execute-only process 
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TOPS- 20 MONITOR CALLS 
(SDSTS) 

SDSTS JSYS 146 



Sets the status of a device. (Refer to Section 2.4 for the 
descriptions of the status bits.) This call requires that the device 
be opened. 

ACCEPTS IN AC1: JFN 

AC2: new status bits 

RETURNS +1: always 



The SDSTS call is a no-op for devices that 
device-dependent status bits. 



do 



not 



have 



The GDSTS monitor call can be used to obtain the status bits for a 
particular device. 

Generates an illegal instruction interrupt on error conditions below. 

SDSTS ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 
DESX5 
DESX9 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not open 

Invalid operation for this device 
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TOPS-20 MONITOR CALLS 
(SDVEC) 

SDVEC JSYS 543 

Sets the entry vector for the Record Management System (RMS) . 

RESTRICTIONS: requires RMS software (currently available only with 
BASIC and COBOL) 

ACCEPTS IN AC1: process handle 

AC2: entry vector length in the left half, and entry 
vector address in the right half 

RETURNS +1: always 

The Record Management System's entry vector is as follows: 

Word Symbol Meaning 

.SDEAD Entry address for the RMS calls 

1 .SDINE Initial entry for the first RMS call 

2 .SDVER Pointer to RMS version block 

3 .SDDMS Address in which to store the RMS call 

4 . SDRPC Address in which to store return PC word 

The GDVEC monitor call can be used to obtain the entry vector for RMS. 

Generates an illegal instruction interrupt on error conditions below. 

SDVEC ERROR MNEMONICS: 

ILINS5: RMS facility is not available 

FRKHX8: Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(SETER) 

SETER JSYS 336 



Sets the most recent error condition encountered by a process. This 
error condition is stored in the process 1 Process Storage Block. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 



process handle 

error code that is to be set 

always 



The GETER monitor call can be used to obtain the most recent error 
condition encountered by a process. 

Generates an illegal instruction interrupt on error conditions below. 

SETER ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Process is running 

Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(SETJB) 

SETJB JSYS 541 



Sets job parameters for the specified job. 
RESTRICTIONS: 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



some functions require WHEEL or OPERATOR capability 
enabled 

job number, or -1 for the current job 

function code 

value for function 

always 



The available functions, along with the legal values for these 
functions, are described below. 



Function 
.SJDEN(O) 



.SJPAR(l) 



.SJDM(2) 



SJRS(3) 



Values 



.SJDDN(O) 
.SJDN2(1) 
.SJDN5(2) 
.SJDN8 (3) 
.SJD16(4) 
.SJD62(5) 



.SJPRO(O) 
.SJPRE(l) 



•SJDDM(O) 
.SJDMC(l) 
.SJDM6 (2) 
.SJDMA(3) 

.SJDM8 (4) 
.SJDMH(5) 



Meaning 

Set default for magnetic tape density. 

System default density 
200 bits/inch (8.1 rows/mm) 
556 bits/inch (22.5 rows/mm) 
800 bits/inch (32.2 rows/mm) 
1600 bits/inch (65.3 rows/mm) 
6250 bits/inch (246 rows/mm) 

Set default for magnetic tape parity. 

Odd parity 
Even parity 

Set default for magnetic tape data mode. 

System default data mode 

Dump mode 

SIXBIT byte mode (7-track; drives) 

ANSI ASCII mode (7 bits in 8-bit 

bytes) 

Industry-compatible mode 

High-density mode for TU70 and TU72 

tape drives only (nine 8-bit bytes in 

two words) 

Set default for magnetic tape record 
size in bytes. The maximum allowable 
number of bytes depends on the hardware 
data mode specified for the drive: 



Data Mode 

default 

dump 

SIXBIT 

ANSI ASCII 

industry compatible 

high density 



Maximum 
Number Bytes 



8192 
49152 
40960 
32768 

8192 
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Function 

.SJRS(3) 
(Cont. ) 



.SJDFS(4) 



.SJSRM(5) 



.SJT20(6) 



.SJDFR(7) 



.SJBAT(IO) 



.SJLLO(ll) 



TOPS-20 MONITOR CALLS 
(SETJB) 



V<alues Meaning 

Note that the SETJB JSYS does not return 
an error message if the above values are 
exceeded. However, the OPENF or the 
first data transfer (whichever is 
performed first after function .SJDM) 
fails. Note that MTOPR function .MOSRS 
can be used to override the default 
record size specified with SETJB 
function .SJDM. 



.SJSPI(O) 
.SJSPD(l) 



-1 




.SJRFA(O) 
.SJRWA(l) 



OB%WTO(3Bl) 



OB%BSS(1B10) 
0B%BSN(177B17 



Set spooling mode. 

Immediate mode spooling 
Deferred mode spooling 

Set remark for current job session. AC3 
contains a pointer to the session 
remark, which is updated on a successful 
return. The first 39 characters of the 
session remark are placed in the job's 
Job Storage Block. 

Indicate if job is at EXEC level or 
program level. 

job is at EXEC level 
job is at program level 

Set job default retrieval. Allows a 
user to override the system default for 
OPENF. 

Any OPENF of a disk file should fail 
if file's contents are not on line. 
This is the system default. 
Any OPENF of a disk file should wait 
for the ARCF JSYS to restore the 
contents of a file to disk. 

Set batch flags and batch stream number 

Write to operator capabilities 



,OBALL(0) 



. OBNWR ( 1 ) 
.OBNOM(2) 



WTO (write to operator) 
and WTOR (write to opera- 
tor with reply) allowed 
No WTR allowed 
No message allowed 



OB%BSN (see below) contains a batch 
stream number 
Batch stream number 

Set job logical location (node name) 



The SETJB monitor call requires the process to have WHEEL or OPERATOR 
capability enabled to set parameters for a job other than the current 
job. 

The GETJI monitor call can be used to obtain the job parameters for a 
specified job. 
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TOPS-20 MONITOR CALLS 
(SETJB) 



Generates an illegal instruction interrupt on error conditions below 
SETJB ERROR MNEMONICS: 



SJBX1 
SJBX2 
SJBX3 
SJBX4 
SJBX5 
SJBX6 
SJBX7 
SJBX8 



Invalid function 

Invalid magnetic tape density 

Invalid magnetic tape data mode 

Invalid job number 

Job is not logged in 

WHEEL or OPERATOR capability required 

Remark exceeds 39 characters 

Illegal to perform this function 
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TOPS- 20 MONITOR CALLS 
(SETNM) 

SETNM JSYS 210 

Sets the private name of the program being used by the current job. 
This name is the one printed on SYSTAT listings. 

ACCEPTS IN AC1: sixbit name used to identify program 

RETURNS +1: always 

The GETNM monitor call can be used to obtain the name of the program 
currently being used. 
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TOPS-20 MONITOR CALLS 
(SETSN) 

SETSN JSYS 506 

Sets either the system name or the private name of the program being 
used by the current job. 

ACCEPTS IN AC1: SIXBIT name to be used as the system name. This name 
is the one used for system statistics. 

AC2: SIXBIT name to be used as the private name. This 
name is the same as the one set with the SETNM call. 

RETURNS +1: failure. (Currently, there are no failure returns 
defined . ) 

+2: success 

System program usage statistics are accumulated in the system tables 
SNAMES, STIMES, and SPFLTS. (Refer to Section 2.3.2.) To make this 
possible, the SETSN call must be executed by each job whenever the 
system program name is changed. In the usual case, the TOPS-20 
Command Language handles this. The argument to SETSN should be: for 
system programs (programs from SYS:), the filename, truncated to six 
characters and converted to SIXBIT; for private programs, " (PRIV) " . 
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TOPS-20 MONITOR CALLS 
(SEVEC) 

SEVEC JSYS 204 



Sets the entry vector of the specified process. The process must run 
in only one section of memory. (Refer to Section 2.3.2.) 

ACCEPTS IN AC1: process handle 

AC2: entry vector word (length in the left half and 
address of first word in the right half), or 

RETURNS +1: always 

A zero in AC2 removes the entry vector for the process. 

The GEVEC monitor call can be used to obtain the process' entry 
vector . 

The XSVEC% monitor call sets the entry vector of a process that runs 
in a section other than section zero. 

Generates an illegal instruction interrupt on error conditions below. 

SEVEC ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 
SEVEX1 



Invalid process handle 

Illegal to manipulate superior process 
Invalid use of multiple process handle 
Illegal to manipulate an execute-only process 
Entry vector length is not less than 1000 
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TOPS-20 MONITOR CALLS 
(SFACS) 

SFACS JSYS 160 



Sets the ACs of the specified process. 

ACCEPTS IN AC1: process handle 

AC2: address of the beginning of a 20 (octal) word table in 
the caller's address space. This table contains the 
values to be placed into the ACs of the specified 
process . 

RETURNS +1: always 

The specified process must not be running. 

The RFACS call can be used to obtain the ACs for a specified process. 

Generates an illegal ^instruct ion interrupt on error conditions below. 

SFACS ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKH-X3 
FRKHX4 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Process is running 

Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(SFBSZ) 

SFBSZ JSYS 46 



Resets the byte size for a specific opening of a file. (Refer to the 
OPENF and RFBSZ calls descriptions.) 



ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



JFN 

byte size, right-justified 

failure, error code in AC1 

success 



The SFBSZ monitor call recomputes the EOF limit and the file's pointer 
based on the new byte size given. 

SFBSZ ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX5: File is not open 

DESX8: File is not on disk 

SFBSX1: Illegal to change byte size for this opening of file 

SFBX2: Invalid byte size 
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TOPS-20 MONITOR CALLS 
(SFCOC) 

SFCOC JSYS 113 



Sets the control character output control (CCOC) for the specified 
terminal. (Refer to Section 2.4.9.2 and the RFCOC call description.) 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



file designator 

control character output control word 

control character output control word 

always 



The CCOC words consist of 2-bit bytes, each byte representing the 
output control for one of the ASCII codes 0-37. 

The SFCOC call is a no-op if the designator is not associated with a 
terminal . 

The RFCOC monitor call can be used to obtain the CCOC words for a 
specified terminal. 

SFCOC ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX5: File is not open 

DEVX2: Device already assigned to another job 

TTYX01: Line is not active 
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TOPS- 20 MONITOR CALLS 
(SFMOD) 

SFMOD JSYS 110 



Sets the program-related modes for the specified terminal. The modes 
that can be set by this call are in the following bits of the JFN mode 
word. (Refer to Section 2.4.9.1.) 

B0(TT%OSP) output suppression control 

B18-B23 (TT%WAK) wakeup control 

B24(TT%ECO) echoes on 

B28-B29 (TT%DAM) data mode 



ACCEPTS IN AC1 

AC2 

RETURNS +1 



file designator 
JFN mode word 
always 



The SFMOD call is a no-op if the designator is not associated with a 
terminal . 

The STPAR monitor call can be used to set device-related modes of the 
JFN mode word, and the RFMOD monitor call can be used to obtain the 
JFN mode word. 

SFMOD ERROR MNEMONICS: 



DESX1 
DESX3 
DESX5 
DEVX2 
TTYX01 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

Device already assigned to another job 

Line is not active 
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TOPS-20 MONITOR CALLS 
(SFORK) 

SFORK JSYS 157 



Starts the specified process in section zero. If the process is 
frozen, the SFORK call changes the PC but does not resume the process. 
The RFORK call must be used to resume the process. 

ACCEPTS IN AC1: f lags ,, process handle 

Flags : 

SF%CON(1BO) Used to continue a process that has 
previously halted. If SF%CON is set, 
the address in AC2 is ignored, and the 
process continues from where it was 
halted . 

AC2: the PC of the process being started. The PC contains 
flags in the left half and the process starting 
address in the right half. This call obtains the 
section number of the PC from the entry vector of the 
process. 



RETURNS 



+1: always 



The SFRKV monitor call can be used to start a process at a given 
position in its entry vector. 

Generates an illegal instruction interrupt on error conditions below. 

SFORK ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX5 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Process has not been started 

Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(SFPOS) 

SFPOS wISYS 526 

Sets the position of the specified terminal's pointer. (Refer to 
Section 2.4.9.4 for information on page lengths and widths of 
terminals . ) 

ACCEPTS IN AC1: file designator 

AC2: position within a page (line number) in the left 
half, and position with a line (column number) in the 
right half 

RETURNS +1: always 

The SFPOS monitor call is a no-op if the designator is not associated 
with a terminal or is in any way illegal. 

The RFPOS monitor call can be used to obtain the current position of 
the terminal's pointer. 

SFPOS ERROR MNEMONICS: 

TTYX01: Line is not active 
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TOPS-20 MONITOR CALLS 
(SFPTR) 



SFPTR JSYS 27 



ACCEPTS 


IN 


AC1 
AC2 


RETURNS 




+ 1 
+ 2 



Sets the position of the specified file's pointer for subsequent I/O 
to the file. The SFPTR call specifying a certain byte number, 
followed by a BIN call, has the same effect as a RIN call specifying 
the same byte number. 

JFN 

byte number to which the pointer is to be set, or -1 
to set the pointer to the current end of the file 

failure, error code in AC1 

success 

The following comments concern line sequence numbers (LSNs) : 

By default, the monitor ignores all LSNs and nulls when doing input 
from a file. (Nulls are used to insure that the LSN starts on a word 
boundary.) When the first byte of the file is read, the monitor checks 
the word containing that byte to see if it is part of an LSN. If it 
is not, the monitor sets an internal flag that is equivalent to 
setting OF%PLN in the OPENF . This flag specifies that all bytes will 
be passed to the user program. If the monitor's internal flag is not 
set, then LSNs and nulls are suppressed. 

If the monitor has not checked the first word of the file (as is the 
case when a process executes an SFPTR JSYS to move the file byte 
pointer to a byte in some other word of the file) and the process did 
not set OF%PLN in the OPENF, then the monitor assumes that the file 
contains LSNs. LSNs and nulls are not passed to the user program. 
Thus nulls will be suppressed even if the file contains no LSNs. In 
this case, if it is desired that nulls should be passed to the user 
program, then OF%PLN should be set in the OPENF, regardless of whether 
the file actually contains LSNs. 

The RFPTR monitor call can be used to obtain the current position of 
the file's pointer. 

SFPTR ERROR MNEMONICS: 



DESX1 

DESX2 

DESX3 

DESX4 

DESX8 

SFPTX1 

SFPTX2 

SFPTX3 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

File is not on disk 

File is not open 

Illegal to reset pointer for this file 

Invalid byte number 
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(SFRKV) 

SFRKV JSYS 201 



Starts the specified process using the given position in its entry 
vector . 



ACCEPTS IN AC1 
AC2 



process handle 

word (0-n) in the entry vector that contains the 
address to use for the start address. Word is 
always the primary start address, and word 1 is the 
reenter address. 



RETURNS 



+1: always 



The process starts execution at the address that is the starting 
address of the entry vector plus the offset specified in AC2. That 
location must contain an executable instruction. 

If the process has a TOPS-10 format entry vector (JRST in the left 
half) , then the left half of AC2 in the SFRKV call is the start 
address offset. The only legal offsets are and 1, and they are only 
legal for entry vector position (start address). Thus, for TOPS-10 
entry vectors, the left half of AC2 will be added to the contents of 
the right half of .JBSA to determine the start address. Entry vector 
position means "use the contents of the right half of .JBSA (120) as 
the start address," and position 1 means "use the contents of the 
right half of .JBREN (124) as the reenter address." 

Note that it is illegal to use an entry vector position other than 
or 1 for an execute-only process. 

Generates an illegal instruction interrupt on error conditions below. 

SFRKV ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX4 
FRKHX8 
SFRVX1 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Process is running 

Illegal to manipulate an execute-only process 

Invalid position in entry vector 
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(SFTAD) 

SFTAD JSYS 534 



Sets the dates and times associated with the specified file. 
RESTRICTIONS: 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



some functions require WHEEL or OPERATOR capability 
enabled 

source designator 

address of argument block 

length of argument block 

always 



Word 


Symbol 





. RSWRT 


1 


.RSCRV 


2 


.RSREF 


3 


.RSCRE 



RSTDT 



RSNET 



The format of the argument block is as follows: 

Meaning 

Internal date and time file was last written. 

Internal date and time file was created. 

Internal date and time file was last referenced. 

System date and time of last write by the monitor. 
(The COPY and RENAME commands in the EXEC change 
this word, for example.) Requires WHEEL or 
OPERATOR capability enabled. 

Tape-write date and time of archived or migrated 
files. Requires WHEEL or OPERATOR capability 
enabled . 

On-line expiration date and time, which can be a 
date and time (in internal format) or an interval 
(in days). Intervals are limited to half-word 
values. Dates, times, and intervals can not 
exceed system or directory maximums. 

Offline expiration date and time, which can be a 
date and time (in internal format) or an interval 
(in days). Intervals are limited to half-word 
values. Dates, times, and intervals can not 
exceed system or directory maximums. 

For words .RSWRT, .RSCRV, and .RSREF, the new values are checked 
against the current date and time. Values greater than the current 
date and time can be set only if the process has WHEEL or OPERATOR 
capability enabled. 

If the designator represents a device for which dates are meaningless 
(dates for terminals, for example), or if any value given is -1, the 
given value is ignored, and the current date, if pertinent, is not 
changed. If the argument block has more than four words, given values 
for these words are checked to be in valid format and then ignored, if 
valid . 



RSFET 
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TOPS-20 MONITOR CALLS 
(SFTAD) 



The following table illustrates which monitor calls set the file dates 
and times: 

Word GTJFN OPENF OPENF CLOSF SFTAD RNAMF APCF 
Read Write Write 

Set 



.RSWRT 


- 


•RSCRV 


Set 


.RSREF 


- 


•RSCRE 


Set 


•RSTDT 


- 


.RSNET 


- 


.RSFET 


- 


LEGEND: 





Set 



Set 



Set 


FDB 


Set 


FDB 


Set 


Set 


Set* 


FDB 


Set* 


FDB 


Set 


FDB 


Set 


FDB 



Set 1 



* Requires WHEEL or OPERATOR capability enabled. 

FDB This word copied from source FDB to destination FDB 



The various SFTAD words map to words in the FDB block. (The mnemonic 
changes from .RS%%% to .FB%%%.) 

The RFTAD monitor call can be used to obtain the dates and times 
associated with a specified file. 

Generates an illegal instruction interrupt on error conditions below. 

SFTAD ERROR MNEMONICS: 



DESX1 

DESX3 

DESX7 

DATE6 

STADX2 

CFDBX2 

OPNX25 

CAPX1: 



Invalid source/destination designator 

JFN is not assigned 

Illegal use of parse-only JFN or output wildcard-designators 

System date and time not set 

Invalid date or time 

Illegal to change specified bits 

Device is write locked 

WHEEL or OPERATOR capability required 
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TOPS-20 MONITOR CALLS 
(SFUST) 

SFUST JSYS 551 



Sets the name of either the author of the file or the user who last 
wrote to the file. 



RESTRICTIONS 



some functions require WHEEL or OPERATOR capability 
enabled 



ACCEPTS IN AC1: function code in the left half, and JFN of the file 
in the right half 

AC2: byte pointer to ASCIZ string containing the name 

RETURNS +1: always, with an updated byte pointer in AC2 

The defined functions are as follows: 

Code Symbol Meaning 

.SFAUT Set the name of the author of the file. 



.SFLWR 



Set the name of the user who last wrote the 
file. 



The GFUST monitor call can be used to return the name of either the 
author of the file or the user who last wrote the file. 

The process must have WHEEL or OPERATOR capability enabled to set the 
writer's name or to have write or owner access to the file to set the 
author ' s name . 

Generates an illegal instruction interrupt on error conditions below. 

SFUST ERROR MNEMONICS: 



SFUSX1 

SFUSX2 

SFUSX4 

SFUSX5 

SFUSX6 

DESX1 

DESX2 

DESX3 

DESX4 

DESX7 

DESX8 

DESX10 

CAPX1: 



Invalid function 

Insufficient system resources 

File expunged 

Write or owner access required 

No such user name 

Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 

File is not on disk 

Structure is dismounted 

WHEEL or OPERATOR capability required 
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(SIBE) 

SIBE JSYS 102 

Tests to see if the designated file input buffer is empty. 

ACCEPTS IN AC1: source designator 

RETURNS +1: (one of the following is true:) 



The device is an active terminal and the input 

buffer is not empty. AC2 contains a count of the 
bytes remaining in the input buffer. 

The device is not a terminal, is open for read, 
and the input buffer is not empty. AC2 contains 

a count of the bytes remaining in the input 
buffer . 



+2: (one of the following is true:) 



1. The device is a non-active terminal. AC2 
contains the error code. 

2. The device is an active terminal and the input 
buffer is empty. AC2 contains zero. 

3. The device is not a terminal and is not open for 
read.. AC2 contains zero. 

4. The device is not a terminal, is open for read, 
and the input buffer is empty. AC2 contains 
zero. 



The SOBE monitor call can be used to determine if the output buffer is 
empty, and the SOBF monitor call can be used to determine if the 
output buffer is full. 

SIBE ERROR MNEMONICS: 



DESX1 
DESX3 
DESX5 
DEVX2 
TTYX01 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

Device already assigned to another job 

Line is not active 
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(SIN) 



SIN 



JSYS 52 



Reads a string from the specified source into the caller's address 
space. The string can be a specified number of bytes, or can be 
terminated with a specific byte. 



ACCEPTS IN AC1 
AC2 
AC3 
AC4 



RETURNS 



+ 1 



source designator 

byte pointer to string in the caller's address space 

count of number of bytes in string, or 

byte (right-justified) on which to terminate input 
(optional) 

always, with updated byte pointers in AC2 and AC1, if 
pertinent, and updated count in AC3, if pertinent 



The contents of AC3 controls the number of bytes to read. 

AC3=0 The string being read is terminated with a byte. 

AC3>0 A string of the specified number of bytes is to be read 
or a string terminated with the byte given in AC4 is to 
be read, whichever occurs first. 

AC3<0 A string of minus the specified number of bytes is to 
be read. 

The contents of AC4 are ignored unless AC3 contains a positive number. 

The input is terminated when the byte count becomes 0, the specified 
terminating byte is reached, the end of the file is reached, or an 
error occurs during the transfer. The program can process an 
end-of-file condition if an ERJMP or ERCAL is the next instruction 
following the SIN call. 

After execution of the call, the file's pointer is updated for 
subsequent I/O to the file. AC2 is updated to point to the last byte 
read or, if AC3 contained 0, the last nonzero byte read. The count in 
AC3 is updated toward zero by subtracting the number of bytes read 
from the number of bytes requested to be read. If the input was 
terminated by an end-of-file interrupt, AC1 through AC3 are updated 
(where pertinent) to reflect the number of bytes transferred before 
the end of the file was reached. 

When the SIN call is used to read data from a magnetic tape, the size 
of the records to read is specified with either the SET TAPE 
RECORD-LENGTH command or the .MOSRS function of the MTOPR call. The 
default record size is lOOO(octal) words. The record size must be at 
least as large as the largest record being read from the tape. 

The SIN call reads across record boundaries on the tape until it reads 
the number of bytes specified in AC3. The call gives the data to the 
program with no indication of tape marks. Thus, if the record is 1000 
bytes and a SIN call is given requesting 2000 bytes, it returns two 
full records to the program. 
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(SIN) 



When reading in reverse, both the number of bytes requested in AC3 and 
the record size should equal the size of the record on the tape. 
(Refer to Section 2.4.7.1 for more information about magnetic tape 
I/O.) 

This call can cause several software interrupts or process 
terminations on certain file conditions. (Refer to bit OF%HER of the 
OPENF call description.) 

Generates an illegal instruction interrupt on error conditions below. 

SIN ERROR MNEMONICS: 



DESXl 

DESX2 

DESX3 

DESX5 

IOX1 

IOX4 

10X5 

IOX7 

10X8 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

File is not open for reading 

End of file reached 

Device or data error 

Insufficient system resources (Job Storage Block full) 

Monitor internal error 



3-397 



TOPS-20 MONITOR CALLS 
(SINR) 

SINR JSYS 531 



Reads a record from the specified device into the caller's address 
space. The maximum size of the record to read is specified with 
either the SET TAPE RECORD-LENGTH command or the .MOSRS function of 
the MTOPR call. The default record size is lOOO(octal) bytes. 



ACCEPTS IN AC1 
AC2 
AC3 
AC4 



RETURNS 



+ 1 



source designator 

byte pointer to string in the caller's address space 

count of number of bytes in string, or 

byte (r ight- j ustif ied) on which to terminate input 
(optional ) 

always, with updated byte pointers in AC2 and AC1, if 
pertinent, and updated count in AC3, if pertinent 



The contents of AC3 and AC4 are interpreted in the same manner as they 
are in the SIN monitor call. 

Each SINR call returns one record to the caller. Thus, the caller can 
read variable-length records by indicating in AC3 the number of bytes 
to read. Upon execution of the call, AC3 is updated to reflect the 
number of bytes read (i.e., the number of bytes in the record). 



The numbe 
the reco 
size to a 
largest 
returned . 
record s 
record si 
record a 
is larger 
but AC3 c 
read. If 
record , 
bytes are 
the next 
next reco 
boundar ie 



r of bytes read depends on the number of bytes 
rd size. When using SINR, the program must 

value greater than or equal to the actual 
record being read from the tape, or an error 
If the SINP call requests the same number of 
ize, the requested number is given to the ca 
ze equals the size of the actual record, all 
re read, and AC3 contains on return. When 

than the actual record, all bytes of the rec 
ontains the difference of the number requested 

the SINR call requests fewer bytes than 
the requested number is given to the caller 

discarded, and an error (IOX10) is returned, 
request for input begins reading at the fi 
rd on the tape because a SINR call never reads 
s . 



requested and 


set the 


record 


size 


of the 


(10X5) 


will be 


bytes 


as the 


Her. When the 


bytes 


in the 


the record size 


o r d are 


read , 


and the 


number 


in the 


actual 


, the remaining 


In all 


cases , 


rst byte 


of the 


across 


record 



When reading in reverse, the number of bytes requested (i.e., the 
count in AC3) should be at least as large as the size of the record on 
the tape. If the requested number is smaller, the remaining bytes in 
the record are discarded from the beginning of the record. 

The action taken on a SINR call differs from the action taken on a SIN 
call. The SIN call reads across record boundaries to read all the 
bytes in a file. The SINR call does not read across record boundaries 
and will discard some bytes in the file if the requested number is 
smaller than the actual record. Can cause several software interrupts 
or process terminations on certain file conditions. (Refer to bit 
0F%HER of the OPENF call description.) 

Generates an illegal instruction interrupt on error conditions below. 
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(SINR) 



SINR ERROR MNEMONICS 



DESXl 

DESX3 

DESX5 

IOX1 

IOX4 

10X5 

10X7 

10X8 

IOX10: 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

File is not open for reading 

End of file reached 

Device or data error 

Insufficient system resources (Job Storage Block full) 

Monitor internal error 

Record is longer than user requested 
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TOPS-20 MONITOR CALLS 
(SIR) 

SIR JSYS 125 



Sets the addresses of the channel and priority level tables for the 
specified process. (Refer to Section 2.6.3.) The process must run in 
one section of memory. The tables must also be in that section. To 
set the table addresses for a process that runs in multiple sections, 
use the XSIR% monitor call. (See also the XRIR% monitor call.) 



ACCEPTS IN AC1: 
AC2 



RETURNS 



+ 1 



process handle 

address of the priority level table in the left half, 
and address of the channel table in the right half 

always. The addresses in AC2 are stored in the 
Process Storage Block. 



If the contents of the tables are changed after execution of the SIR 
call, the new contents will be used on the next interrupt. 

The RIR monitor call can be used to obtain the table addresses for a 
process that runs in a single section. 

Generates an illegal instruction interrupt on error conditions below. 

SIR ERROR MNEMONICS: 

SIRX1: Table address is not greater than 20 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 

FRKHX8: Illegal to manipulate an execute-only process 



TOPS-20 Version 5 



3-400 



April 1982 



TOPS- 20 MONITOR CALLS 
(SIRCM) 

SIRCM JSYS 142 



Sets the mask for reserved software interrupt channels for the 
specified inferior process. Conditions occurring on software channels 
that have the corresponding mask bit set do not generate an interrupt 
to the inferior process. Instead, the conditions cause the process to 
terminate or freeze. 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



inferior process handle 

channel mask with bits set for reserved channels 

deferred terminal interrupt word 

always 



The RIRCM 
software 
channel ma 
for infer 
process to 
traps) . 
symbol aft 
ERJMP or 
the superi 
call. 



monitor call can be 
interrupt channels 
sk, it cannot set i 
ior processes. Thi 

monitor an inferio 
However, if the in 
er instructions tha 

ERCAL will preven 
or will not be able 
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Although a process 
ts own; the SIRCM call 
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t the generation of the 
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can read its own 
can be given only 
ty for a superior 
tructions, memory 
an ERJMP or ERCAL 
on failure, the 
interrupt. Thus, 
with the SIRCM 



Generates an illegal instruction interrupt on error conditions below. 
SIRCM ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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(SIZEF) 

SIZEF JSYS 36 



Returns the length of an existing file. 

ACCEPTS IN AC1: JFN 

RETURNS +1: failure, error code in AC1 

+2: success, byte count that referenced the last byte 
written into the file in AC2, and number of pages 
(512 words) in file in AC3. The byte count returned 
depends on the byte size recorded in the FDB and not 
on the byte size specified in the OPENF call. 

For a file with holes, the byte count in AC2 does not reflect the 
file's actual size. 

The GTFDB monitor call can be used to obtain the byte size in which 
the file was written. 

SIZEF ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 
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(SJPRI) 

SJPRI JSYS 245 



Sets the scheduler priority control word. This word controls the 
priority of a job and the permissible range of queues that the job may 
run in. The priority word is set for the top process and for all 
existing inferior processes. Also, the priority word is passed down 
to any forks that are created subsequent to the SJPRI call. 



RESTRICTIONS: 



ACCEPTS IN AC1 



This JSYS is reserved for DEC 
OPERATOR capability enabled. 

job number 



Requires WHEEL or 



AC2: priority word 
RETURNS +1: always 
The priority word has the following format 








17 18 


24 29 30 


35 


1 


PERC 


i i 


! HIGH ! LOW 


i 



Where 
PERC 

B18 

LOW 
HIGH 



is the percentage of CPU resources to be guaranteed for the 
job. This value may be in the range 0<= n <=99. 

is the flag (JP%SYS) that designates the job as a system 

job. System jobs get a higher priority than all user jobs, 

and the scheduler gives them all the time they need for 
execution. 

is the lowest priority queue the job may run in. This queue 
is always specified as the desired queue + 1. For example, 
queue 2 is specified as 3. 

is the highest priority queue the job may run in 



A priority word containing zero in the left half means no CPU 
percentage is being requested. A priority word containing zero in the 
right half means no queue assignments are being requested. 

Because this call assigns priority to a job, it is indeterminate how 
processes within a job that compete for the job's run time will be 
scheduled. Use of this call for a job containing more than one 
process implies that the processes must cooperate. 

Note that the high queue is high in priority but low in numerical 
value while the low queue is low in priority but high in numerical 
value . 

Generates an illegal instruction interrupt on error conditions below. 

SJPRI ERROR MNEMONICS: 

WHELX1: WHEEL or OPERATOR capability required 

SJPRXl: Job is not logged in 
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TOPS- 20 MONITOR CALLS 
(SKED%) 

SKED% JSYS 577 

Reads or modifies the monitor's scheduler data base. 

RESTRICTIONS: Some functions require WHEEL or OPERATOR capability 
enabled 

ACCEPTS IN AC1: function code 

AC2: address of argument block 

RETURNS +1: always 

The available functions are: 

Code Symbol Function 

1 .SKRBC Read bias control knob setting. Return a value 

indicating the setting of the bias control knob. 
This setting determines whether the scheduler favors 
compute-bound jobs or interactive jobs. 

Argument block: 

Word Symbol Contents 

. SACNT Count of words in argument block 

(Including this word) 

1 . SAKNB Bias control knob setting 

2 .SKSBC Set bias control setting to the specified value. 

The setting of this value controls the bias between 
interactive and compute-bound jobs. The lower the 
setting, the more interactive jobs are favored. The 
higher the setting, the more compute-bound jobs are 
favored. Currently, the value may be an integer n 
such that 1<= n <=20. Requires WHEEL or OPERATOR 
capabilities enabled. 

Argument block: 

Word Symbol Contents 

.SACNT Count of words in argument block 

(Including this word) 

1 .SAKNB Bias control knob setting 

3 . SKRCS Read class parameters. Returns the following 

values : 

1. Class of the job 

2. Share of the processor allocated for this class. 
The share is returned as a floating-point value 
n, such that 0<= n <=1. 

3. Amount of processor actually used by the class. 
The amount used is returned as a floating-point 
value n, such that 0<= n <=1. 
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(SKED%) 

Code Symbol Function 

3 .SKRCS (Cont.) 

4. 1 minute load average. The load average = (J/P) 
where J is the number of CPU-runnable jobs in 
the class for the time period and P is the 
fraction of CPU allocated to the class. Thus 3 
jobs running in a 50% class would produce a load 
average of 6. 

5. 5 minute load average 

6. 15 minute load average 
Argument block: 

Word Symbol Contents 

. SACNT Count of words in argument block 

(Including this word) 



1 


.SACLS 


Class 


2 


.SASHR 


Share 


3 


.SAUSE 


Use 


4 


.SA1ML 


1 minute load average 


5 


.SA5ML 


5 minute load average 


6 


.SA15L 


15 minute load average 



.SKSCS Set class parameters (as described above). Requires 
WHEEL or OPERATOR capability. 

Argument block: 

Word Symbol Contents 

.SACNT Count of words in argument block 

(Including this word) 

1 .SACLS Class 

2 .SASHR Share 

.SKICS Start or stop the class scheduler. If the class 
scheduler is being started, this function also 
specifies the mode in which class-to-user 
assignments are made and whether windfall is to be 
allocated to the active classes or withheld from the 
active classes. Requires WHEEL or OPERATOR 
capability. 
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(SKED%) 



Code 


Symbol 






5 


.SKICS 


(Cont. ) 








Word 


Symbol 









. SACNT 



Function 



Contents 

Count of words in argument block 
(Including this wocd) 

1 .SACTL Control flags 

The flags are as follows: 

Bit Symbol Meaning 

BO SK%ACT Class by 
accounts 

Bl SK%WDF Withhold 
windfall 

B2 SK%STP Class 

scheduler off 

SKSCJ Set the class of a job. This function takes a pair 
of numbers, the job to set and the desired class. 
If setting the class of the calling job, this 
function is not privileged. If setting the class of 
another job, it requires WHEEL or OPERATOR 
capabilities enabled. In either case, the job must 
be allowed to reside in the selected class. The 
calling job may be designated by -1. 

Argument block: 

Contents 

Count of words in argument block 
(Including this wocd) 

Job number 

2 .SAJCL Class of job 

3 .SAWA Windfall allocation 
.SKRJP Read class parameters for a job 

Returns the following values: 

1. Job's share of the processor. This value is 
returned as a floating-point value n, such that 
0<= n <=1. 

2. Job's use of the processor. This value is 
returned as a floating-point value n, such that 
0<= n <=1. 



Word 


Symbol 





.SACNT 


1 


.SAJOB 
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(SKED%) 

Code Symbol Function 

7 .SKRJP Argument block: 
(Cont.) 

Word Symbol Contents 

.SACNT Count of words in argument block 

(including this word) 

1 .SAJSH Job's share allotment 

2 .SAJUS Job's current use 

10 .SKBCR Read the class setting for batch jobs. A -1 

indicates that there is no special class for batch 
jobs . 

Argument block: 

Word Symbol Contents 

.SACNT Count of words in argument block 

(Including this word) 

1 .SABCL Batch class 

11 .SKBCS Set batch class. Specifies the class in which all 

batch jobs will run. A -1 indicates no special 
class for batch jobs. If this value is specified, 
it overrides the valid classes for any user running 
a batch job. Requires WHEEL or OPERATOR capability. 

Argument block: 

Word Symbol Contents 

.SACNT Count of words in argument block 

(Including this word) 

1 .SABCL Batch class 

12 .SKBBG Run all batch jobs in the "dregs" queue. The dregs 

queue is a special queue whose processes are only 
allowed to run when no normally scheduled processes 
are available to run. Requires WHEEL or OPERATOR 
capability. 

This function applies only if the class scheduler is 
not being used. The argument is either (clear) or 
non-zero (set) . A non-zero indicates that batch 
jobs should be run in the "dregs" queue. 

Argument block: 

Word Symbol Contents 

.SACNT Count of words in argument block 

(Including this word) 

1 .SADRG Flag word 

= don't run in dregs queue 
non-zero = run in dregs queue 
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Code Symbol 

13 .SKDDC 

14 .SKRCV 



Reserved 
Read status. 
Argument block: 
Word Symbol 







.SACNT 



.SACTL 



SKED% ERROR MNEMONICS 

ARGX02 

ARGX04 

ARGX08 



ARGX15 
ARGX25 
ARGX29 
ARGX30 
ARGX31 
CAPX1: 
SKDX1: 



Invalid function 
Argument block too small 
No such job 



Function 



Contents 

Count of words in argument block 
(Including this word) 

Flags 

The flags are as follows: 

Bit Symbol Meaning 

SK%ACT 



BO 



Bl 



B2 



B3 



SK%WDF 



SK%STP 



SK%DRG 



Job is not logged in 

Invalid class 

Invalid class share 

Invalid KNOB value 

Class scheduler already enabled 

WHEEL or OPERATOR capability required 

Cannot change class 



Class by 
accounts 

Withhold 
windfall 

Class 
scheduler off 

Batch jobs are 
being run in 
dregs queue 
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SKPIR JSYS 127 



Tests to see if the software interrupt system is enabled for the 
specified process. 

ACCEPTS IN AC1: process handle 

RETURNS +1: failure, software interrupt system is off 

+2: success, software interrupt system is on 

The EIR monitor call is used to enable the software interrupt system, 
and the DIR monitor call is used to disable the system. 

Generates an illegal instruction interrupt on error conditions below. 

SKPIR ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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SMAP% JSYS 767 

Maps one or more contiguous sections of memory. This call removes any 
existing mapping from the section or sections named as the 
destination. To learn the contents of a section map, use the RSMAP% 
monitor call. The four SMAP% functions are discussed below. 

Case I: Mapping File Sections to a Process 

This function maps one or more sections of a file to a process. All 
pages that exist in the source sections are mapped to the destination 
sections . 

To map a process section to a file, use the PMAP monitor call. 

ACCEPTS IN AC1: source identifier: JFN,,file section number 

AC2: destination identifier: fork handle ,, process section 
number 



AC3 : flags , , count 



The flags determine access to the 

destination section, and the count is the 

number of contiguous sections to be 

mapped. The count must be between 1 and 
37. The flags are as follows. 
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B2(SM%RD) Allow read access 

B3(SM%WR) Allow write access 

B4(SM%EX) Allow execute access 

B18-35 The number of sections to map. This 
number must be between 1 and 37. 

RETURNS +1: always 

Case II: Mapping Process Sections to a Process 

This function maps one or more sections of memory from one process to 
another. All pages that exist in the source sections are mapped to 
the destination sections. 

ACCEPTS IN AC1 : source identifier: fork handle ,, sect ion number 

AC2: destination identifier: fork handle ,, section number 

AC3: f .'lags, , count 

The flags determine access to the 

destination section, and the count is the 

number of contiguous sections to be 

mapped. This count must be between 1 and 

37. All source sections that exist are 

mapped to destination sections. The 
flags are as follows. 

B.2(SM%RD) Allow read access 

B3(SM%WR) Allow write access 

B4(SM%EX) Allow execute access 

B6(SM%IND) Map the destination section using an 

indirect section pointer. Once the 

destination section map is created, the 

indirect section pointer causes the 

destination section map to change in 
exactly the same way that the source 
section map changes. 

B18-35 Count of the number of contiguous 
sections to be mapped. 

RETURNS +1: always 

If you map a source section into a destination section with SM%IND 
set, SMAP% creates the destination section using an indirect pointer. 
This means that the destination section will contain all pages that 
exist in the source section, and the contents of the destination pages 
will be identical to the contents of the source pages. 

In addition, changes that occur in the source section map after SMAP% 
creates the destination section cause the same changes to be made in 
the destination section map. This ensures that both the source 
section and the destination section contain the same data. 

If SM%IND is not set, SMAP% creates the new section using a shared 
pointer. After SMAP% maps the destination section, changes that occur | 
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in the source section's map do not cause any change in the destination 
section's map. Thus after a short time the source and destination 
sections might contain different data. 

If you request a shared pointer (SM%IND not set) to the destination 
section, what happens depends on the contents of the source section 
when the SMAP% call executes. The outcome is one of the following. 

1. If the source section does not exist, the SMAP% call fails. 

2. If the source is a private section, a mapping to the private 
section is established, and the destination process is 
co-owner of the private section. 

3. If the source section contains a file section, the source 
section is mapped to the destination section. Although files 
do not actually have section boundaries, this monitor call 
views them as having sections that consist of 512 contiguous 
pages. Each file section starts with a page number that is 
an integer multiple of 512. 

4. If the source section map is made by means of an indirect 
section pointer, SMAP% follows that pointer until the source 
section is found to be nonexistent, a private section, or a 
section of a. file. 
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Case III: Creating a Section 

This function creates a new, private section. It does not map any 
pages into the new section. 

A process must use SMAP% to create a non-zero section before 
referencing such a section. A reference to a nonexistent section 
fails with an illegal memory reference error. Note, however, that if 
a process uses PMAP to map a page to a nonexistant section, the 
monitor creates a private section and the PMAP succeeds. 



ACCEPTS IN AC1 
AC2 
AC3 





destination identifier: fork handle ,, sect ion number 

flags , , count 



The flags determine access to the destination section, and the count 
is the number of contiguous private sections to be created. This 
count must be between 1 and 37. The flags are as follows. 

B2(SM%RD) Allow read access 

B3(SM%WR) Allow write access to the created 
section. This function sets this bit by 
default to avoid the creation of a 
read-only or execute-only private 
section . 



B4 (SM%EX) 
B6 (SM%IND) 
E18-35 



Allow execute access to the 
section. 



created 



Create the section using an indirect 
pointer . 

Count of the number of contiguous 
sections to be created. This number must 
be between 1 and 37. 



RETURNS 



+1: always 



Case IV: Deleting Process Sections 

This function removes (unmaps) a section or several contiguous 
sections of a process. 



ACCEPTS IN AC1 
AC2 
AC3 



-1 

destination identifier: fork handle ,, sect ion number 

, , count 

The count is the number of contiguous sections to be 

unmapped. This number must be between 1 and 37. 



RETURNS 



+1: always 



If the section being removed (unmapped) was created with a shared 
pointer, and if the removing fork is not the owner of the section, 
then SMAP% decrements the share count for the section and deletes the 
shared pointer. This is always true when the memory sections being 
deleted contain file sections. 
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If the pointer being deleted is the last pointer to a private section, 
then SMAP% clears the page table for that section. But if the owning 
fork attempts to unmap a private section to which other forks have 
shared or indirect pointers, the SMAP% call fails. 

Generates an illegal instruction interrupt on error conditions below. 



ARGX23 
ARGX24 
SMAPX1 
SMAPX2 



Invalid section number 

Invalid count 

Attempt to delete a section still shared 

Indirect section map loop detected 
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SMON 



JSYS 6 



Sets various flags; and parameters in the monitor's data base. Most 
flag-oriented items are set by specifying 1 in AC2 and cleared by 
specifying in AC2 . In a few cases (noted in the text), 
flag-oriented items are set by setting and clearing the appropriate 
bit(s) in AC2. Value-oriented items are set to the value in AC2. 



RESTRICTIONS: 

ACCEPTS IN AC1 
AC2 



requires WHEEL or OPERATOR capability enabled 

functions are for ARPANET systems only. 

function code 

new value for the indicated function 



Some 



RETURNS +1: always 

The codes for the functions are as follows: 



Code Symbol 






.SFFAC 


1 


•SFCDE 


2 


.SFCDR 


3 


.SFMST 


4 


•SFRMT 


5 


.SFPTY 


6 


.SFCTY 


7 


.SFOPR 


10 


.SFLCL 


11 


.SFBTE 


12 


.SFCRD 


13 


•SFNVT 


21 


•SFUSG 


22 


.SFFLO 



23 
24 

25 



SFMTA 
SFMSO 

SFMS1 



44 


.SFNTN 


45 


.SFNDU 


46 


.SFNHI 


47 


.SFTMZ 


50 


.SFLHN 


51 


.SFAVR 


52 


.SFSTS 


53 


.SFSOK 



FACT file en 
CHECKD found 
CHECKD is ru 
Manual start 
Remote LOGIN 
PTY LOGINS a 
CTY LOGINS a 
Operator is 
Local LOGINS 
Bit table er 
Users can 
parameters w 
ARPANET term 
USAGE file e 
Disk latency 
register is 
enabled unle 
Revision L 
processor i 
processor is 
If set, indi 
is enabled. 
Set system m 



Meaning 

tries are allowed. 

errors, 
nning . 

is in progress, 
s (dataset lines) are allowed, 
re allowed, 
re allowed, 
in attendance. 

(hardwired lines) are allowed, 
rors found on startup. 

change nonpr ivileged directory 
ith the CRDIR monitor call, 
inal LOGINS are allowed, 
ntries are allowed. 

optimization using the RH20 backup 

enabled. This feature is not to be 

ss the M8555 board of the RH20 is at 

evel D AND either of the KL10-C 

s at Revision Level 10 or KL10-E 

at Revision Level 2. 
cates that MOUNTR magtape allocation 

essage level 



AC2: 1 (SF%MS0) to set; to clear 

Set system message level 1 

AC2: 1 (SF%MS1) to set; to clear 

Turn ARPANET on. 

Reinitialize ARPANET if it is down. 

Initialize ARPANET host table. 

Set the local time zone to the value given in AC2. 

Set the local ARPANET host number to the value 

given in AC2. 

Account validation will be running on this system. 

Enable/disable status reporting. 

Set GETOK% defaults 

AC2: Flags, ,GETOK% function code 
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53 



Code Symbol 

.SFSOK 
(Cont. ) 



54 

55 
56 

57 



60 



.SFMCY 

.SFRDU 
.SFACY 

.SFRTW 



SFTDF 



61 



SFWSP 
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Meaning 
Flags : 



Bit Symbol Meaning 



BO SF%EOK 



Bl SF%DOK 



= Disable access checking 

1 = Enable access checking 

= Deny access if checking disabled 

1 = Allow access if checking disabled 



This 
acces 
insta 
of t 
the d 
being 
Insta 
be en 
If th 
actio 
for a 



fun 
s-con 
llati 
he de 
ef aul 
ch 
llati 
abled 
ere i 
n of 
ny in 



ct ion 
trol 
on) t 
sired 
t act 
ecked 
on-de 
/d isa 
s no 

the 
stall 



should 
program 
o turn on 

f unct ions 
ion for ea 

by the 
fined func 
bled by us 
access-con 
GETOK% JS 
a t ion-def i 



be 

acce 
I 
ch f 
ace 
t ion 
ing 
trol 
YS w 
ned 



given 
(suppl led 
ss checki 
t is also 
unction t 
ess-contr 

codes (4 
function 

program, 
ill be to 
function 



by the 

by the 

ng for each 

used to set 

hat is not 

ol program. 

00000+n) can 

code 400000. 

the default 

deny access 

code . 



See the description of the GETOK% JSYS for 
function codes. 



GETOK% 



expiration period 
for ordinary files. 

expiration period 
for archive files. 



Specifies the maximum offline 

(tape recycle period) in days, 

Read date update function 

Specifies the maximum offline 

(tape recycle period) in days, 

Sets/clears the no-retrieval-waits flag in the 

monitor. When set, this specifies that those file 

retrievals requests that are waiting for the 

retrieval should fail rather than wait. 

Set tape mount controls 



Flags 



■ it 



B0 



Symbol Meaning 

MT%UUT 1 unload unrecognizable tapes 
treat unrecognizable tapes 
as unlabeled 



Enable working set preloading 



The TMON monitor call can be used to obtain the settings of the 
various monitor flags. 

Generates an illegal instruction interrupt on error conditions below. 

SMON ERROR MNEMONICS: 

SMONX1: WHEEL or OPERATOR capability required 

SMONX2: Invalid SMON function 
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SNDIM JSYS 750 

Places a message in a previously assigned ARPANET special message 
queue . 

RESTRICTIONS: for ARPANET systems only. 

ACCEPTS IN AC1: BitO: If set, the message contains a 96-bit 

leader. If reset, the message contains 
a 32-bit leader. 
Bitl: If set, the data resides in the 
high-order 32 bits of each word of the 
message. If reset, the data resides in 
all 36 bits of each word of the message. 
Bits 18-35: Special Queue Header 

AC2: address of an extended message 

RETURNS +1: failure, error code in AC1 

+2: success, message queued 

See the ARPANET manual for the format of the message. 

The RCVIM JSYS can be used to retrieve a message from the special 
message queue. 



SNDIM ERROR MNEMONICS 



SNDIX1 

SNDIX2 

SNDIX3 

SNDIX4 

SNDIX5 

SQX1: 

SQX2: 



Invalid message size 

Insufficient system resources (no buffers available) 

Illegal to specify NCP links 0-72 

Invalid header value for this queue 

IMP down 

Special network queue handle out of range 

Special network queue not assigned 
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SNOOP JSYS 516 

Performs system performance analysis. The process can patch any 
instruction in the monitor with this call. For example, the user 
program can build a PC histogram by patching an instruction in the 
code for the 1 . O-millisecond clock. 

The general procedure for using the SNOOP call is as follows: 

1. The user program supplies a set of breakpoint routines that 
are called by the monitor when control reaches one of the 
patched instructions. These routines are mapped into the 
monitor's address space into an area selected by the monitor. 
Thus, the routines must have self-relocating code or must be 
relocated by the user program to where they will be run, 
based on the monitor address supplied by the monitor. 

2. The user program defines a number of breakpoints, analogous 
to DDT breakpoints. 

3. The user program inserts all of the breakpoints 
simultaneously. 

4. The user program goes to "sleep" or waits for terminal input 
while its breakpoint routines obtain control. 

5. When the user program determines that the routines have 
completed, it removes the breakpoints. 

The user program breakpoint routines run in the monitor address space, 
which means that the addresses of the code and the data are monitor 
addresses. The user program must modify these addresses, based on the 
values returned by the monitor, after the initialization but before 
the "snooping." The breakpoint routines must preserve any 
accumulators they use. Also, they must not cause a page fault if at 
interrupt level or if a patch has been made in the page fault handler 
or in the scheduler. Thus, the breakpoint routines should test for 
swappable code being in memory before referencing it. If swappable 
code needs to be referenced, the swappable monitor can be locked in 
memory, if desired. When a patch is made to a routine called at many 
interrupt levels, the program must specify a reentrant instruction to 
be used for patching. 

RESTRICTIONS: requires WHEEL or OPERATOR capability enabled 

ACCEPTS IN AC1: function code 

AC2: function-specific argument 

AC3: function-specific argument 

AC4: function-specific argument 

RETURNS +1: failure, error code in AC1 

+2: success 
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The following functions are available: 



Function Symbol 
Code 

.SNPLC 



.SNPLS 



.SNPDB 



Meaning 



Declare and lock code into the monitor's 
address space. 

AC2: number of pages desired 

AC3: page number in user space of start of 
breakpoint routines to be locked 

On return, the pages are locked contiguously 
in the monitor's address space, and AC2 
contains the monitor page numbers 
corresponding to the given user page number. 

Lock the swappable monitor. This function is 
useful for analyzing swappable data at 
interrupt level. On return, the entire 
swappable monitor is locked. 

Define a breakpoint 

AC2: number of breakpoint 

AC3: address in monitor space to be patched. 
The patched instruction can be a skip 
type instruction or a PUSHJ 
instruction, and the patching is 
similar to that in DDT. The routines 
will receive control before the patched 
instruction is executed. 

AC4: instuction to be executed before the 
patched instruction is executed. The 
instruction can be: 

JSR LOC where LOC is an address in 
monitor space of the user's routine. 

PUSHJ P,LOC when reentrant or recursive 
code is patched. 

AOS LOC to count frequency of monitor 
execution points. 

The error return is given if 
breakpoints have already been inserted. 



NOTE 

Putting a SNOOP breakpoint on a PUSHJ 
or other subroutine call instruction 
(including JSYS , MDISMS, etc) can 
cause problems. If the process is 
not in a NOSKED state already, it can 
be rescheduled during the breakpoint, 
in which case the breakpoint is 
removed, and the subsequent return is 
made to non-existent code. 
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Function 


Symbol 


Code 




3 


.SNPIB 


4 


.SNPRB 


5 


.SNPUL 


6 


.SNPSY 



.SNPAD 



SNOOP ERROR MNEMONICS 

SNOPX1 

SNOPX2 

SNOPX3 



Meaning 

Insert all breakpoints and start analyzing. 

Remove all breakpoints and stop analyzing. 

Unlock and release all storage, and undefine 
and remove all breakpoints. 

Obtain the address of a monitor symbol. 

AC2: radix-50 symbol 

AC3 : radix-50 program name if a local 
address is desired. If AC3 is 0, the 
entire symbol table is searched. 

On return, AC2 contains the monitor address 
or value of the symbol. 

Obtain a monitor symbol. 

AC2: 36-bit value of symbol that is to be 
looked up in the monitor's symbol 
table. 

AC3: radix-50 program name if a local value 
is desired. If AC3 is 0, the entire 
symbol table is searched. 

On return, AC2 contains the first radix-50 
monitor symbol that is closest to and has a 
value less than the specified value, and AC3 
contains the difference between the value of 
the symbol returned and the specified value. 



SNOPX4 
SNOPX5 
SNOPX6 
SNOPX7 
SNOPX8 
SNOPX9 
SNOP10 
SNOP11 



WHEEL or OPERATOR capability required 

Invalid function 

. SNPLC function must be first 



Only one .SNPLC function allowed 

Invalid page number 

Invalid number of pages to lock 

Illegal to define breakpoints after inserting them 

Breakpoint is not set on instruction 

No more breakpoints allowed 

Breakpoints already inserted 

Breakpoints not inserted 
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SNOP12: Invalid format for program name symbol 

SNOP13: No such program name symbol 

SN0P14: No such symbol 

SN0P15: Not enough free pages for snooping 

SN0P16: Multiply-defined symbol 

SN0P17: Breakpoint already defined 

SN0P18: Data page is not private or copy-or-wr ite 
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SOBE JSYS 103 



Tests to see if the designated file output buffer is empty. 

ACCEPTS IN AC1: destination designator 

RETURNS +1: output buffer is not empty. Number of bytes 
remaining in output buffer is returned in AC2. 

+2: output buffer is empty; AC2 contains 0. This return 
is given if an error occurs on the call; AC2 
contains the appropriate error code. 

If the designator is not associated with a terminal, the +2 return is 
given . 

The SIBE call can be used to determine if the input buffer is empty. 

SOBE ERROR MNEMONICS: 



DESX1 
DESX3 
DESX5 
DEVX2 
TTYX01 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

Device already assigned to another job 

Line is not active 
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SOBF JSYS 175 

Tests to see if the designated file output buffer is full. 

ACCEPTS IN AC1: file designator 

RETURNS +1: output buffer is not full. This return is given if 
an error occurs on the call; AC2 will contain 0. 

+2: output buffer is full 

On either return, the number of bytes remaining in the output buffer 
is returned in AC2 (if no error occurred on the call). 
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SOUT JSYS 53 

Writes a string from the caller's address space to the specified 
destination. The string can be a specified number of bytes or 
terminated with a specified byte. 

destination designator 

byte pointer to string to be written 

count of the number of bytes in string, or 

byte (right-justified) on which to terminate output 

always, with updated string pointers in AC2 and AC1, 
if pertinent, and updated count in AC3, if pertinent 

The contents of AC3 controls the number of bytes to write. 

AC3=0 The string being written is terminated with a byte. 

AC3>0 A string of the specified number of bytes is to be 
written or a string terminated with the byte given in 
AC4 is to be written, whichever occurs first. 

AC3<0 A string of minus the specified number of bytes is to 
be written. 



ACCEPTS IN 


AC1 




AC2 




AC3 




AC4 


RETURNS 


+ 1 



The contents of AC4 is ignored unless the contents of AC3 
positive number. 



is 



The output is terminated when the byte count becomes 0, the specified 
terminating byte is reached, or an error occurs during the transfer. 
The specified terminating byte is copied to the destination. 

After execution of the call, the file's pointer is updated for 
subsequent I/O to the file. AC2 is updated to point to the last byte 
written or, if AC3 contained 0, the last nonzero byte written. The 
count in AC3 is updated toward zero by subtracting the number of bytes 
written from the number of bytes requested to be written. 



When the SOUT call is used to write dat 
a series of bytes packed into record 
The size of the records to write is spe 
RECORD-LENGTH command or the .MOSRS f 
default record size is lOOO(octal) word 
1000 bytes, two SOUT calls, each wr i 
record. If during the writing, the end 
error (IOX5) is given. However, t 
written and the device status word has 
this condition. Refer to Section 2.4 
magnetic tape I/O. 



a to a magnetic tape, it sends 
s of the specified record size, 
cified with either the SET TAPE 
unction of the MTOPR call. The 
s. Thus, if the record size is 
ting 500 bytes, would write one 
of tape mark was passed, an 
he data has been successfully 
the MT%EOT bit sot to indicate 
.7.1 for more information about 



Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 
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Generates an illegal instruction interrupt on error conditions below 
SOUT ERROR MNEMONICS: 



DESXl 

DESX2 

DESX3 

DESX5 

IOX2 

10X5 

10X6 

10X7 

10X8 

10X11 

10X33 

10X34 

10X35 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

File is not open 

File is not opened for writing 

Device or data error 

Illegal to write beyond absolute end of file 

Insufficient system resources (Job Storage Block full) 

Monitor internal error 

Quota exceeded 

TTY input buffer full 

Disk full 

Unable to allocate disk - structure damaged 
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SOUTR JSYS 532 



Writes a variable-length record from the caller's address space to the 
specified device. 

If the record is to be written to magnetic tape, the maximum size of 
the record to write is specified with either the SET TAPE 
RECORD-LENGTH command or the .MOSRS function of the MTOPR call. The 
default record size is lOOO(octal) bytes. 



ACCEPTS IN AC1 
AC2 
AC3 
AC4 



RETURNS 



+ 1 



destination designator 

byte pointer to string to be written 

count of number of bytes in string, or 

byte ( r ight- justified) on which to terminate output 
(optional ) 

always, with updated byte pointers in AC2 and AC1, if 
pertinent, and updated count in AC3, if pertinent 



The contents of AC3 and AC4 are interpreted in the same manner as they 
are in the SOUT monitor call. 

Each SOUTR call writes at least one record. Thus, the caller can 
write variable-length records by indicating in AC3 the number of bytes 
to write in the record. If the SOUTR call requests more bytes to be 
written than the maximum record size, then records of the maximum size 
are written, plus another record containing the remaining bytes. If 
the SOUTR call requests fewer bytes than the maximum, or a number 
equal to the maximum, to be written, then records of the requested 
size are written. 

The SOUTR call differs from the SOUT call in that the SOUTR call 
writes records on the tape upon execution of the call. The SOUT call 
does not write a record on the tape until the number of bytes equal to 
the record size have been written. Thus, if a record is being made 
from several strings in the caller's address Space, the SOUT call can 
be used for the first strings and the SOUTR call for the last string. 

Can cause several software interrupts or process terminations on 
certain file conditions. (Refer to bit OF%HER of the OPENF call 
description. ) 

Generates an illegal instruction interrupt on error conditions below. 
SOUTR ERROR MNEMONICS: 



DESX1 

DESX3 

DESX5 

10X2 

10X5 

10X6 

10X7 

10X8 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

File is not open for writing 

Device or data error 

Illegal to write beyond absolute end of file 

Insufficient system resources (Job Storage Block full) 

Monitor internal error 
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IOX9: 
10X11 
10X34 
10X35 



Function legal for sequential write only 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 
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(SPACS) 

SPACS JSYS 60 

Sets the accessibility of a page. This call affects the map word of 
the page named in AC1 (no indirect pointers are allowed). 

ACCEPTS IN AC1: process/file designator in the left half, and page 
number within the file or process in the right half 

AC2: access information 

B2(PA%RD) permit read access 

B3(PA%WT) permit write access 

B4 (PA%EX) permit execute access 

B9(PA%CPY) copy-on-write 

RETURNS +1: always 

When used to modify a process page, the SPACS call does not allow any 
greater access than can be obtained with the PMAP call (i.e., the 
access specified on the OPENF call is applied to SPACS operations 
involving file pointers) . 

The SPACS call does not allow bits to be set in a page that does not 
already exist. 

The RPACS monitor call can be used to obtain the accessibility of a 
page . 

Generates an illegal instruction interrupt on error conditions below. 

SPACS ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX5: File is not open 

DESX8: File is not on disk 

SPACX1: Invalid access requested 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 

FRKHX8: Illegal to manipulate an execute-only process 
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(SPJFN) 

SPJFN JSYS 207 



Sets the primary JFNs (.PRIIN and .PRIOU) for the specified process. 

ACCEPTS IN AC1: process handle 

AC2: primary input JFN in the left half, and primary 
output JFN in the right half 



RETURNS 



+1: always 



The JFNs given cannot be either 100 or 101. These JFNs cause the 
specified process to receive an error on any primary I/O operation. 
If minus one is placed in the appropriate half of AC2, the primary 
input/output JFNs are set to the process 1 controlling terminal. 

The GPJFN monitor call can be used to obtain the primary JFNs. 

Generates an illegal instruction interrupt on error conditions below. 

SPJFN ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
DESX3: 



Invalid process handle 

Illegal to manipulate a superior process 
Invalid use of multiple process handle 
JFN is not assigned 
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(SPLFK) 

SPLFK JSYS 314 



Splices a process structure. The process that becomes the new 
superior must be either the one executing the SPLFK monitor call, or 
an inferior of it. The new inferior process must be an inferior of 
the executing process. The new superior process must not be the same 
process as the new inferior process, and must not be inferior to the 
new inferior process. The new inferior process and all of its 
inferiors will be frozen after execution of the SPLFK call. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 

+ 2 



process handle of the new superior process 

process handle of the new inferior process 

failure, error code in AC1 

success, a process handle in AC1. This handle may be 
used by the new superior process (in AC1) to refer to 
its new inferior (in AC2) . 



SPLFK ERROR MNEMONICS 



SPLFX1 
SPLFX2 
SPLFX3 
FRKHX1 



Process is not inferior or equal to self 

Process is not inferior to self 

New superior process is inferior to intended inferior 

Invalid process handle 
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TOPS-20 MONITOR CALLS 
(SPOOL) 

SPOOL JSYS 517 



Defines and initializes a device to be used for input spooling or sets 
and reads the directory for a spooled device. 



RESTRICTIONS: 
ACCEPTS IN AC1 



RETURNS 



AC2 
+ 1 
+ 2 



requires WHEEL or OPERATOR capability enabled 

length of argument block in the left half, and 
function code in the right half 

address of argument block 

failure, error code in AC1 

success 



The format of the argument block is different depending upon the 
particular function desired. The available functions, along with 
their argument block formats, are as follows: 



Code 




Symbol 
.SPLDI 



.SPLSD 



Meaning 

Define an input spooling 
argument block is: 



device 



The 



Word Symbol 



Meaning 



.SPLDV Device designator of input 

device. 

1 .SPLNA Pointer to name string 

comprising the set of files to 
be input. 

2 .SPLGN Generation number of first 

file. This number is 
incremented by 1 each time the 
spooled device is opened. 

Set the directory of the spooled device. The 
argument block is: 



Word Symbol 




Meaning 



.SPLDV Device designator of spooled 
device . 

.SPLDR Directory number. This number 
is the logged-in directory 
number of the user who opened 
the spooled device. 



This function requires the process to have 
WHEEL or OPERATOR capability enabled. 
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Code Symbol Meaning 

2 .SPLRD Read the directory of the spooled device. 

The argument block is: 

Word Symbol Meaning 

.SPLDV Designator of spooled device. 

The directory number of the spooled device is 
returned in word 1 of the argument block. 

To read from a spooled input device, the user first defines the name 
of the files comprising his set of spooled input files. The files 
have names in the format: 

STR:<SPOOLED-DIRECTORY>DEVICE-DIR#.NAME.l,2,3, . . . 

The spooled directory is the directory to receive any spooled input 
from the device. The .SPLSD function can be used by a privileged 
process to set the directory. The default directory for all of the 
spooled devices is <SPOOL>. 

The device is the name of the device being used for spooled input. It 
is the same name that was given on the original GTJFN call. 

The directory number is the logged-in directory number of the user 
that opened the spooled device. 

The name is the name of the set of files to be input. The .SPLDI 
function is used to define this name. 

The generation number begins with the value specified by the .SPLDI 
function and increments by one each time the spooled device is opened. 

Thus, if the input spooler for the card reader (CDR) is reading files 
for a user whose directory number is 23, then the files might have 
names like 

<SPOOL>CDR- 2 3. BATCH-SEQUENCE- 3 7. 1,2, 3, . . . 

To initialize the spooled card reader, the user would then execute the 
SPOOL call giving "BATCH-SEQUENCE-37" as the name of the set of files 
to be input and "1" as the beginning generation number. 

SPOOL ERROR MNEMONICS: 



SPLX1 
SPLX2 
SPLX3 
SPLX4 
SPLX5 
SPLX6 



Invalid function 

Argument block too small 

Invalid device designator 

WHEEL or OPERATOR capability required 

Illegal to specify as generation number for first file 

No directory to write spooled files into 
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(SPRIW) 

SPRIW JSYS 243 

Sets the priority word for the specified process. 

RESTRICTIONS: requires WHEEL or OPERATOR capability enabled 

ACCEPTS IN AC1: process handle 

AC2: priority word 

RETURNS +1: always 

Refer to the SJPRI monitor call description for the format of the 
priority word. 

Generates an illegal instruction interrupt on error conditions below. 

SPRIW ERROR MNEMONICS: 

WHELX1: WHEEL or OPERATOR capability required 
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(SSAVE) 

SSAVE JSYS 203 

Creates a sharable, save-format file for the given JFN by copying (not 
sharing) pages from the given process. (Refer to Section 2.8.2 for 
the format of a sharable save file.) This monitor call is used for 
creating programs that can be shared. It saves the file in groups of 
contiguous pages for which the same access is desired. SSAVE closes 
and releases the given JFN. 

ACCEPTS IN AC1: process handle in the left half, and JFN in the right 
half 

AC2: one table entry, or in the left half and the 
address of the table in the right half (see below) 

AC3: second word of two-word table entry (if bit SS%EPN is 
set in AC1) or 

RETURNS +1: always 

If the pages to be saved are all in section zero, the table has a 
one-word entry for each group of pages. 

If any of the groups of pages to be saved is in a non-zero section, 
the table entry for that group is two words long (see below). Bit 
SS%EPN must be set in the first word, and bits 27-35 are zero in the 
first word. The second word contains the number of the first page in 
the group (r ight- just if ied) . 

A zero word ends the table. 

The first word of each table entry has the following format: 

Meaning 

Negative of the number of pages in each group 
(r ight- just if ied) . 

Allow copy-on-wr ite access to the group of 
pages . 

Limit the access according to the current 
access of the user's page. (See below.) 

Allow read access to the group of pages. 

Allow write access to the group of pages. 

Allow execute access to the group of pages. 

Each table entry is two words long, and the 
second word contains the page number of the 
first page of each group. 

27-35 SS%FPN If SS%EPN is not set, this field contains the 

number of the first page in the group 
(right-justified). If SS%EPN is set, this 
field is zero, and the number of the first 
page in the group is in word two of this 
table entry. 
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Bit 


Symbol 


0-17 


SS%NNP 


18 


SS%CPY 


19 


SS%UCA 


20 


SS%RD 


21 


SS%WR 


22 


SS%EXE 


23 


SS%EPN 



TOPS-20 MONITOR CALLS 
(SSAVE) 

When B19(SS%UCA) is set, the access to the group of pages is 
determined by ANDing the access bits specified in the table word with 
the corresponding access bits for the user's pages (as determined by 
the RPACS call) . This means that a given access is allowed only if 
both the SSAVE call indicates it and the page currently has it. If 
B19(SS%UCA) is not set, the access granted to the group of pages is 
that indicated by the bits set in the table word. 

The SSAVE call does not save the accumulators nor does it save 
nonexistent pages., 

The GET monitor call is used to map a file saved with the SSAVE call 
back into a given process. 

Can cause several software interrupts or process terminations on 
certain file conditions. 

Generates an illegal instruction interrupt on error conditions below. 

SSAVE ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
SSAVX1 
SSAVX2 
SSAVX3 
SSAVX4 
10X11: 
10X34: 
10X35: 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to save files on this device 

Page count (left half of table entry) must be negative 

Insufficient system resources (Job Storage Block full) 

Directory area of EXE file is more than one page 

Quota exceeded 

Disk full 

Unable to allocate disk - structure damaged 



All I/O errors can also occur 
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TOPS-20 MONITOR CALLS 
(STAD) 

STAD JSYS 226 

Sets the system's date. (Refer to Section 2.9.2.) 

RESTRICTIONS: Some functions require WHEEL or OPERATOR capability 
enabled 

ACCEPTS IN AC1: day in the left half, and fraction of the day in the 
right half 

RETURNS +1: failure, error code in AC1 

+2: success 

The STAD call requires the process to have WHEEL or OPERATOR 
capability enabled if the system's date is already set. 

The GTAD monitor call can be used to obtain the system's date. 

STAD ERROR MNEMONICS: 

STADX1: WHEEL or OPERATOR capability required 

STADX2: Invalid date or time 
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(STCMP) 

STCMP JSYS 540 

Compares two ASCIZ strings in the caller's address space. Note that 

letters are always considered as upper case, regardless of their case 

within the string. Therefore, the strings ABC and abc are considered 
an exact match. 

ACCEPTS IN AC1: byte pointer to test string 

AC2: byte pointer to base string 

RETURNS +1: always, with 

AC1 containing the compare code: 

B0(SC%LSS) Test string is less than base string. 

B1(SC%SUB) Test string is a subset of base 
s t r i ng . 

B2(SC%GTR) Test string is greater than base 
str ing . 

AC2 containing base byte pointer, updated such that 
an ILDB instruction will reference the first 
nonmatching byte. 

One string is considered less than another string if the ASCII value 
of the first nonmatching character in the first string is less than 
the ASCII value of the character in the same position in the second 
string . 

One string is considered a subset of another string if both of the 
following conditions are true: 

1. From left to right, the ASCII values of the characters in 
corresponding positions are the same. 

2. The test string is shorter than the base string. 

Two strings are considered equal if the ASCII values of the characters 
in corresponding positions are the same and the two strings are the 
same size. In this case, the contents of AC1 is on return. 
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TOPS-20 MONITOR CALLS 
(STDEV) 

STDEV JSYS 120 



Translates the given device name string to its corresponding device 
designator. 



ACCEPTS IN AC1 

RETURNS +1 

+ 2 



byte pointer to the string to be translated 

failure, error code in AC2 

success, device designator (refer to Section 2.4) in 
AC2 



The string to be translated is terminated by the first space (ASCII 
code 40), null (ASCII code 0), or colon (ASCII code 72)., 

The DEVST monitor call can be used to translate a device designator to 
its corresponding string. 

STDEV ERROR MNEMONICS: 

STDVX1: No such device 
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TOPS-20 MONITOR CALLS 
(STI) 

STI JSYS 114 



Simulates terminal input. 
RESTRICTIONS: 



ACCEPTS IN AC1 

AC2 

RETURNS +1 



some functions require WHEEL or OPERATOR capability 
enabled 

file designator (only terminal designators are legal) 

character to be input, r ight- just if ied 

always 



The character is taken from the accumulator and placed into the 
specified terminal's input buffer whether or not the buffer is empty. 
The DIBE call can be used to prevent sending an interrupt character 
(e.g., CTRL/C) before the program has processed all of the previous 
input. 

The STI monitor call requires the process to have WHEEL or OPERATOR 
capability enabled if the specified terminal either is not assigned or 
opened by the process or is not accepting advice. (Refer to the TLINK 
bit TT%AAD.) 

The use of this monitor call is not recommended for pseudo-terminals 
(PTYs) . The recommended procedure for placing a character in the PTY 
input buffer is to open the PTY for output with OPENF and then perform 
output with the BOUT call. 

Generates an illegal instruction interrupt on error conditions below. 

STI ERROR MNEMONICS: 



TTYX1 

DESX2 

DEVX2 

WHELX1 

TTYX01 



Device is not a terminal 
Terminal is not available to this job 
Device already assigned to another job 
WHEEL or OPERATOR capability required 
Line is not active 
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(STIW) 

STIW JSYS 174 

Sets the terminal interrupt word (refer to Section 2.6.6) for the 
entire job or a specific process. This call declares that terminal 
characters that usually cause an interrupt are instead to be passed to 
the program as input. In actuality, the STIW call sets the interrupt 
word mask, thus determining for each of the 36 terminal codes if the 
job or process should receive an interrupt. The call's effect is 
different, depending on whether the call is being executed for the 
entire job or for a specific process in the job. 

When the STIW call is executed for the entire job, codes corresponding 
to the bits on in the mask will cause an interrupt if a process in the 
job has enabled for an interrupt on that code. If multiple processes 
have enabled that code, the lowest inferior process receives the 
interrupt. (If several processes at the same lowest level have 
enabled the code, the process that receives the interrupt is 
determined by the system.) If no process has enabled that code, the 
character corresponding to the code is passed to the program. Also, 
characters are passed to the program when their corresponding bits are 
off in the mask, even if a process has enabled that code. Initially, 
all codes are declared to cause an interrupt (i.e., all bits in the 
mask are on) , and the program can execute the RTIW call to determine 
the current status. Thus if the program wishes to read a terminal 
interrupt character as input, it executes the STIW call for the entire 
job and turns off the mask bit corresponding to the character. 

When the STIW call is executed for a specific process in the job, 
codes corresponding to the bits on in the mask are assumed to be 
enabled by the specific process and cause an interrupt if in fact they 
are enabled. If the process has not enabled for the code, the 
character corresponding to the code is ignored, if it is typed. 
Characters corresponding to the bits off in the mask are assumed not 
to be enabled by the process. This use of the STIW call is implicitly 
executed on an ATI call. 

Each time the STIW call is executed for a specific process, the mask 
is changed to reflect the bits changed in that process. 

The STIW call sets or clears specific terminal codes for a particular 
process without actually changing the channel assignment that each 
code has. The ATI call is used to set the channel assignment, and the 
DTI call is used to clear the assignment. 

The STIW call requires the process to have SC%CTC capability enabled 
to disable the code for CTRL/C interrupts or to give -5 as an 
argument . 

ACCEPTS IN AC1: B0(ST%DIM) set the deferred terminal interrupt mask 

given in AC3 

B18-B35 process handle, or -5 for entire job 
(ST%PRH) 

AC2: terminal interrupt word mask. 

Bit n on means terminal code n is enabled. 

AC3: deferred terminal interrupt word mask. 

Bit n on means terminal code n is deferred. 

RETURNS +1: always 
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The argument in AC3 is ignored, and no change is made to the deferred 
interrupt word mask, if BO (ST%DIM) is not set or if the process handle 
in AC1 does not indicate a specific process. 

If multiple processes enable the same interrupt character and any one 
of the processes declares it deferred, the character is deferred for 
all the processes that enabled it. 

The RTIW call can be used to obtain the terminal interrupt word masks. 

STIW ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(STO) 

STO JSYS 246 



Simulates terminal output. 

ACCEPTS IN AC1: file designator (only terminal designators are legal) 

RETURNS +1: always, with the character r ight- justified in AC2 

The character is taken from the specified terminal's output buffer and 
placed in the accumulator. The process is blocked until the character 
is in the accumulator. 

The use of this monitor call is not recommended for pseudo-terminals 
(PTYs) . The recommended procedure for reading a character from the 
PTY output buffer is to open the PTY for input with OPENF and then 
perform input with the BIN call. 

Generates an illegal instruction interrupt on error conditions below. 

STO ERROR MNEMONICS: 



TTYX1 
DESX2 
DEVX2 
TTYX01 



Device is not a terminal 
Terminal is not available to this job 
Device already assigned to another job 
Line is not active 
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(STPAR) 

STPAR JSYS 217 



Sets the device-related modes for the specified terminal. The modes 
that can be set by this call are in the following bits of the JFN mode 
word. (Refer to Section 2.4.9.1.) 



Bl (TT%MFF) 
B2 (TT%TAB) 
B3 (TT%LCA) 
B4-B10 (TT%LEN) 
B11-B17 (TT%WID) 
B25 (TT%ECM) 
B30 (TT%UOC) 
B31(TT%LIC) 
B32-B33 (TT%DUM) 
B34 (TT%PGM) 

ACCEPTS IN AC1 : 

AC2: 

RETURNS +1: 



mechanical form feed 

mechanical tab 

lower case 

page length 

page width 

echo control 

uppercase output control 

lowercase input control 

duplex mode 

output page mode 



file designator 
JFN mode word 
always 



The STPAR monitor call is a no-op if the designator is not associated 
with a terminal . 

The SFMOD monitor call can be used to set program-related modes of the 
JFN mode word, and the RFMOD monitor call can be used to obtain the 
JFN mode word. 

When the page length and width fields are set with the STPAR call, 
they have a maximum range of 127. The MTOPR call can be used to set 
these fields to values greater than 127. A nonzero value of less than 
2 for the length or less than 10 for the width causes STPAR to leave 
the field unchanged. 

STPAR ERROR MNEMONICS: 



DESX1 
DESX3 
DESX5 
DEVX2 
TTYX01 



Invalid source/destination designator 

JFN is not assigned 

File is not open 

Device already assigned to another job 

Line is not active 
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(STPPN) 

STPPN JSYS 556 



Translates the given directory name string to its corresponding 
project-programmer number (a TOPS-10 36-bit directory designator). 
This project-programmer number is associated with the structure 
containing the given directory and is valid only for the current 
mounting of that structure. The STPPN monitor call and the PPNST 
monitor call should appear only in programs that require translations 
of project-programmer numbers. Both calls are temporary calls and may 
not be defined in future releases. 



RESTRICTIONS 



ACCEPTS IN AC1 



RETURNS 



+ 1 



When this call is used in any section other than 
section zero, one-word global byte pointers used as 
arguments must have a byte size of seven bits. 

byte pointer to ASCIZ string containing the directory 
name, a JFN, or a 36-bit directory number 

always, with the corresponding project-programmer 
number in AC2 



Generates an illegal instruction interrupt on error conditions below. 
STPPN ERROR MNEMONICS: 



STRX02 

STRX03 

STRX04 

DESX1 

DESX2 

DESX3 

DESX4 

DESX7 

DESX8 

DESX10 



Insufficient system resources 

No such directory name 

Ambiguous directory specification 

Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal use of parse-only JFN or output wildcard-designators 

File is not on disk 

structure is dismounted 
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TOPS- 20 MONITOR CALLS 
(STSTS) 

STSTS JSYS 25 



Clears the status of a file. (Refer to the GTSTS monitor call for the 
format of the JFN status word.) 



ACCEPTS IN AC1 
AC2 



RETURNS 



+ 1 
+ 2 



JFN in the right half 

STSTS flags. If a given STSTS flag is zero, then the 

associated flag in the JFN status word is cleared. 

If a given STSTS flag is one, no action is performed. 

Any undocumented bits in AC2 are ignored. 

failure, error code in AC1 
success 



The STSTS call is used to clear the following bits of the status word: 

B9 (GS%ERR) file may be in error 

B13(GS%HLT) I/O errors are terminating conditions (set by OPENF) 
B17(GS%FRK) this is a restricted JFN. Only the process that 
received it may use it. Other processes may reference 
the file with other JFNs . (Set by GTJFN) 

STSTS ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 
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(STTYP) 

STTYP JSYS 302 

Sets the terminal type number for the specified terminal line. (Refer 
to Section 2.4.9.4. ) 

ACCEPTS IN AC1: terminal designator are legal) 

AC2: terminal type number 

RETURNS +1: always 

The STTYP call sets the bits in the JFN mode word for mechanical form 

feed and tab, lower case, and page length and width according to their 

settings in the device characteristics word. These bits can 
subsequently be changed with the STPAR monitor call. 

The GTTYP monitor call can be used to obtain the terminal type number 
for a specified line. 

Generates an illegal instruction interrupt on error conditions below. 

STTYP ERROR MNEMONICS: 

DESX1: Invalid source/destination designator 

DESX2: Terminal is not available to this job 

STYPX1: Invalid terminal type 

TTYX01: Line is not active 
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(SWJFN) 

SWJFN JSYS 47 



Swaps the association of two JFNs by literally exchanging all 
information cells of each JFN. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 



JFN 

another JFN 

always 

Generates an illegal instruction interrupt on error conditions below. 
SWJFN ERROR MNEMONICS: 



DESX1 
DESX2 
DESX3 
DESX4 
SWJFX1 



Invalid source/destination designator 

Terminal is not available to this job 

JFN is not assigned 

Invalid use of terminal designator or string pointer 

Illegal to swap same JFN 
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(SWTRP%) 

SWTRP% JSYS 573 



Provides a process with the ability to intercept arithmetic overflow 
or underflow conditions efficiently. Use of the SWTRP% JSYS to trap 
for these conditions is more efficient in some applications than using 
the software interrupt system. 

SWTRP% also allows a process to declare its LUUO block for LUUO ■ s 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



process handle 
function code 

function-dependent argument 
always 



The functions are as follows: 
Code Symbol 



Function 



.SWART Set arithmetic trap location 

AC3 contains the address of the arithmetic trap 
block (see LUUO block below). A zero in AC3 clears 
the arithmetic trap. 

1 .SWRAT Read arithmetic trap location 

Returns the trap block address in AC3 (see LUUO 
block below). A zero is returned if an arithmetic 
trap is not set. 

2 .SWLUT Set LUUO block address for non-zero sections 

AC3 contains the address. A zero in AC3 clears the 
location. See below for the format of the LUUO 
block . 

3 .SWRLT Read LUUO block address 

Returns the address in AC3. A zero is returned if 
no block is currently in effect. 

The LUUO block has the following format: 



Offset 
.ARPFL(O) 
.AROPC (1) 
.AREFA(2) 
.ARNPC (3) 



! PC 


fl 


ags 


! opcode ! AC ! 


! 


! 


i 




Location of LUUO +1 


i 


! 


i 




E of the LUUO 


i 


! 


i 




New PC 


i 



5 6 



35 
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(SWTRP%) 

An LUUO executed in section zero will store the opcode, AC, and 
effective address of the LUUO in user location 40, and will execute 
the instruction in user location 41. An LUUO executed in a non-zero 
section makes use of the UPT (user process table) . SWTRP% allows a 
process to store the desired address in the UPT so that subsequent 
LUUO's will produce the desired effect. The address in the UPT points 
to the LUUO block shown above. This block is stored in the user's 
address space) . See the Hardware Reference Manual for more 
information on LUUO's. 
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(SYERR) 

SYERR JSYS 527 

I Places information in the System Error file (ERROR. SYS) . (Refer to 
the SPEAR Manual for information on the system error file, 
<SYSTEM-ERROR>ERROR.SYS. ) 

RESTRICTIONS: requires WHEEL, OPERATOR, or MAINTENANCE capability 
enabled 

ACCEPTS IN AC1: address of argument block 

AC2: length of argument block 

RETURNS +1: always 

The first four words of the header block must contain the standard 
I header information required by SPEAR. 

Generates an illegal instruction interrupt on error conditions below. 

SYERR ERROR MNEMONICS: 



CAP XI 
SYEX1 
SYEX2 



WHEEL or OPERATOR capability required 

Unreasonable SYSERR block size 

No buffer space available for SYSERR 
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TOPS- 20 MONITOR CALLS 
(SYSGT) 

SYSGT JSYS 16 

Returns the table number, table length, and word of the specified 
system table. (Refer to Section 2.3.2 for the names of the system 
tables . ) 

ACCEPTS IN AC1: SIXBIT table name 

RETURNS +1: always, with 

AC1 containing word of the table 

AC2 containing the negative of the number of words in 
the table in the left half, and the table number 
in the right half 

The table number returned can be given to the GETAB monitor call as an 
argument. However, because the MONSYM file includes symbol 
definitions for the system tables, execution of the SYSGT call is not 
required to obtain the table number for the GETAB call. 

The contents of AC2 is on return if the specified table was not 
found . 
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TOPS-20 MONITOR CALLS 
(TBADD) 

TBADD JSYS 536 

Adds an entry to a standard-formatted command table used for user 
program command recognition. (Refer to the TBLUK call description for 
the format of the command table.) 

ACCEPTS IN AC1: address of word (header word) of table 

AC2: entry to be added to table. (Refer to the TBLUK call 
for the format of a table entry.) 

RETURNS +1: always, with address in the table of the new entry in 
AC1 

Generates an illegal instruction interrupt on error conditions below. 

TBADD ERROR MNEMONICS: 

TADDX1: Table is full 

TADDX2: Entry is already in table 
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(TBDEL) 

TBDEL JSYS 535 

Deletes an entry from a standard-formatted command table used for user 
program command recognition. (Refer to the TBLUK call description for 
the format of the command table.) 

ACCEPTS IN AC1: address of word (header word) of table 

AC2: address of entry to be deleted. This address is 
returned in AC1 on a TBLUK call. 

RETURNS +1: always 

Generates an illegal instruction interrupt on error conditions below. 

TBDEL ERROR MNEMONICS: 

TDELX1: Table is empty 

TDELX2: Invalid table entry location 
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TOPS-20 MONITOR CALLS 
(TBLUK) 

TBLUK JSYS 537 



Compares the specified string in the caller's address space with 
strings indicated by a command table. The table has a standard 
format, which is described below. 

This call is used to implement a consistent style of command 
recognition and command abbreviation for user programs. The TBLUK 
call performs the function of string lookup in the table, and the 
TBADD and TBDEL calls perform the functions of adding to and deleting 
from the table. 

The command table has the following format: 



Word 


1 through n 



Meaning 

Number of entries in the table (not including this 
entry) in the left half, and maximum number of 
entries in the table (not including this entry) in 
the right half. 

Address of an argument block in the left half; 
the right half of each table entry is available 
for use by the user program. 

The argument block can have one of two formats. Bits 0-7 of the first 
word of the argument block determine which format the argument block 
has . 

If bits 0-6 are all off and B7 (CM%FW) is on, the string begins in the 
next word of the argument block, and the remainder of this word 
contains data bits relevant to the string. 

Table Entry 



Argument Block 



17 1! 



ADR 



for use by program 



35 

:= I 



ADR 



6 7 
111 



data bits 



start of string 



35 

:= I 
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(TBLUK) 



The following bits are currently defined: 

Bit Symbol Meaning 

34 CM%NOR Do not recognize this string, even if a string is 
specified that matches exactly, and consider an 
exact match as ambiguous. A program can set this 
bit to include entries that are initial substrings 
of other entries in the table to enforce a minimum 
abbreviation of these other entries (e.g., to 
include D and DE in the table to enforce DEL as 
the minimum abbreviation of DELETE) . 

7 CM%FW Indicate that the remainder of this word is a flag 

word containing data bits relevant to the string. 

This bit must be on to distinguish a flag word 
from a null string. 

If any bit of bits 0-6 of the first word of the argument block is on 
or if B7 (CM%FW) is off, the string begins in that word. In this case, 
the data bits do not apply and are assumed to be off. 

Table Entry 



17 18 35 

:============================================] 

ADR ! ! 

============================================ i 



Argument 



ADR 



35 

=================================== i 

start of string ! 

===================================1 



The addresses in the command table must be sorted according to the 
alphabetical order of the strings. Note that letters are always 
considered as uppercase. Therefore, the strings ABC and abc are 
considered equivalent strings. This order results in efficient 
searching of strings and determination of ambiguous strings. 

The right half of each table entry can be used by the program for an 
address to a dispatch table for the command or for a pointer to a 
parameter block for additional information about the call. The 
contents of this half word is ignored by the three table calls. 

ACCEPTS IN AC1: address of word (header word) of table 

AC2: byte pointer to string in caller's address space that 
is to be compared with the string in the table 
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(TBLUK) 

RETURNS +1: always, with 

AC1 containing the address of the entry that matches 
the input string or address where the entry would 
be if it were in the table. 

AC2 containing recognition bits: 

B0(TL%NOM) The input string does not match any 

string in the table. 
Bl (TL%AMB) The input string matches more than one 

string in the table (i.e., is 

ambiguous) . 
B2(TL%ABR) The input string is a valid 

abbreviation of a string in the table. 
B3(TL%EXM) The input string is an exact match 

with a string in the table. 
AC3 containing a byte pointer to the remainder of the 
string in the table if the match was on an 
abbreviation (TL%ABR is on). This string can 
then be output to complete the command. 

Generates an illegal instruction interrupt on error conditions below. 

TBLUK ERROR MNEMONICS: 

TLUKX1: Internal format of table is incorrect 
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TOPS-20 MONITOR CALLS 
(TEXTI) 

TEXTI JSYS 524 

Reads input from a terminal or a file into a string in the caller's 
address space. Input is read until either a specified break character 
is encountered or the byte count is exhausted, whichever occurs first. 

When used for terminal input, the TEXTI call handles the following 
editing functions: 

1. Delete the last character input (DELETE). 

2. Delete back to the last punctuation character (CTRL/W) . 

3. Delete back to the beginning of the current line or, if the 
current line is empty, back to the beginning of the previous 
line (CTRL/U) . 

4. Retype the current line from its beginning or, if current 
line is empty, retype the previous line (CTRL/R) . 

5. Accept the next character without regard to its usual meaning 

(CTRL/V) . 

ACCEPTS IN AC1: address of argument block 

RETURNS +1: failure, error code in AC1 

+2: success, updated pointer in word .RDDBP, appropriate 
bits set in the left half of word .RDFLG, and updated 
count in word .RDDBC of the argument block 

The format of the argument block is as follows: 

Meaning 

Count of words following this word in the 
argument block. 

Flag bits. (See below.) 

Byte pointer to string, or input JFN in the 
left half and output JFN in the right half 
(if RD%JFN is on in the flag word .RDFLG). 
The input JFN is where the input is being 
read from, and the output JFN is where any 
output generated from character editing is 
placed . 

.RDDBP Byte pointer to string in caller's address 
space where input is to be placed 
(destination string pointer). 

.RDDBC Number of bytes available in the destination 
string (field width) . 



Word 


Symbol 





. RDCWB 


1 


.RDFLG 


2 


.RDIOJ 
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(TEXTI) 



Word 
5 



Symbol 
.RDBFP 



.RDRTY 



RDBRK 



Meaning 

Byte pointer to the beginning of the 
destination buffer. This pointer indicates 
the maximum limit to which the user can edit 
back into the buffer with DELETE, CTRL/W, or 
CTRL/U. This buffer is not separate (i.e., 
is not disjoint) from the destination string. 
On the first TEXTI, this pointer is normally 
the same as the destination byte pointer 
(.RDDBP) , but does not have to be the same. 
If the count in word . RDCWB is 4, then the 
byte pointer in word .RDDBP will be used as 
the pointer to the destination buffer. 



Byte pointer to 
prompting-text (C 
along with any 
buffer, is output 
his first line of 
CTRL/R text or the 
than the first lin 
in the destinati 
The CTRL/R buffer 
characters that 
such as a prompt f 
in this buffer ca 
and if the user de 
thi s buffer , his 
has deleted all of 
logically adjacent 
but may be physica 
the CTRL/R buffe 
terminated with a 



the beg 

TRL/R buf 

text in 

if the use 

input . 

user type 

e of input 

on buffer 

is usef 

preceded 

rom the pr 

nnot be ed 

letes back 

action is 

his input 

to the de 

lly disjoi 

r is dis 

null byte. 



inning of the 

fer) . This text, 

the destination 

r types CTRL/R on 

If there is no 

s CTRL/R on other 

, only the text 

will be output. 

ul for retyping 

the user ' s input , 

ogram. The text 

ited by the user , 

to the end of 

treated as if he 

This buffer is 

stination buffer, 

nt from it. When 

joint, it must be 



Address of a 4-word block of break character 
mask bits. If a bit is on in the mask, then 
the corresponding character is considered a 
break character. Any bits set in this mask 
override break characters set in the flag 
wor d . 

The mask occupies the leftmost 32 bits of 
each word, thereby allowing a mask of 128 
bits. The rightmost 4 bits of each word are 
ignored. The mapping is from left to right. 
The ASCII character set maps into this 
128-bit mask. 



If this word is zero, there is no break 
character set mask defined. 



10 



RDBKL 



Byte poi 
destinat 
the posi 
which t 
informed 
to the 
has been 
by the 
equal to 
( .RDBFP) 
(.RDDBP) 



nter to 
ion buff 
tion in 
he user 
This p 
program 
edited a 
program, 
the sta 
or to th 
or be be 



the backup 
er. This po 
the destinat 

can edit bac 
ointer is use 

that previou 
nd may need t 
The pointe 
rt of the 
e destination 
tween these t 



limit 
inter i 
ion bu 
k witho 
d to 
sly par 
o be 
r can e 
buffer 

str ing 
wo poin 



in 
ndic 
ffer 
ut b 
indi 
sed 
repa 
ithe 
poi 
poi 
ters 



the 
ates 
to 
eing 
cate 
text 
rsed 
r be 
nter 
nter 
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Words 5 through 10 (.RDBFP through .RDBKL) in the argument block are 
optional. A zero in any of the words means that no pointer has been 
given. 

The illustration below is a logical arrangement of the CTRL/R and 
destination buffers, with the placement of the pointers when they are 
given as not being equal. Remember that the CTRL/R buffer does not 
have to be adjacent to the destination buffer and that two or more of 
these pointers can be equal. 



destination buffer 



f 



can be edited 



CTRL/R buffer; 
cannot be edited, 
and will be output 
on a CTRL/R 



! Can be edited, ! 

! but user is ! 

! informed ! 

i i 



CTRL/R 
buffer 
pointer 
( .RDRTY) 



Beginning of 
destination 
buffer pointer 
( .RDBFP) 



Backup 
limit 
pointer 
( .RDBKL) 



t t 



Destination 
str ing 
pointer 
(.RDDBP) 



The flag bits that can be set in word 1 (.RDFLG) of the argument block 
are as follows: 



Bit 

1 



Symbol 
RD%BRK 
RD%TOP 

RD%PUN 



RD%BEL 



RD%CRF 



RD%RND 



Meaning 

Break on CTRL/Z or ESC. 

TOPS-10 character set. Break on CTRL/G, 
CTRL/K, CTRL/L, CTRL/Z, ESC, carriage return, 
line feed. 

Break on punctuation: 



CTRL/A-CTRL/F 
CTRL/H-CTRL/I 
CTRL/N-CTRL/Q 
CTRL/S-CTRL/T 
CTRL/X-CTRL/Y 



ASCII codes 34-37 

ASCII codes 40-57 

ASCII codes 72-100 

ASCII codes 133-140 

ASCII codes 173-176 



Break on end of line (carriage return 
line feed, or line feed only). 



and 



Suppress a carriage return and return a line 
feed only. 

Return to user program if the user tries to 
delete beyond the beginning of the 
destination buffer. If this bit is not set, 
the TEXTI call causes the terminal's bell to 
ring and waits for more input. 
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(TEXTI) 



Bit Symbol Meaning 

6 RD%JFN JFNs have been given for the source 

designator (word .RDIOJ of the argument 
block). If this bit is not set, the source 
designator is a pointer to a string. 

7 RD%RIE Return to user program if the input buffer is 

empty. If this bit is not set, the TEXTI 
call waits for more input. 

8 RD%BBG Not used 

9 RD%BEG Causes TEXTI to return when the .RDBKL 

pointer is reached and TEXTI is about to wait 
for more input. 

10 RD%RAI Convert lowercase input to uppercase input. 

11 RD%SUI Suppress the CTRL/U indication if user types 

a CTRL/U (i.e., do not print XXX and on 
display terminals, do not delete the 
characters from the screen) . 

On a successful return, the following bits can be set in word 1 
(.RDFLG) of the argument block: 



Bit 
12 

13 
14 



Symbol Meaning 

RD%BTM A break character terminated the input. If 
this bit is not set, the input was terminated 
because the byte count was exhausted. 

RD%BFE Control was returned to the user program 
because the user tried to delete beyond the 
beginning of the destination buffer and 
RD%RND was on in the call. 



The backup limit for editing was reached. 



RD%BLR 
TEXTI ERROR MNEMONICS: 

ARGX17: Invalid argument block length 
RDTX1: Invalid string pointer 
10X11: Quota exceeded 
10X34: Disk full 
10X35: Unable to allocate disk - structure damaged 
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TOPS-20 MONITOR CALLS 
(TFORK) 

TFORK JSYS 321 

Sets and removes monitor call intercepts (JSYS traps) for the given 
inferior processes. 

When the process attempts to execute a call on which an intercept has 
been set, that process is suspended before it executes the call. Once 
the process is suspended, the monitor passes control to the closest 
superior process that is monitoring the execution of that call. 

The superior process can then use the RTFRK call to determine which 
process caused the interrupt, and how to handle the interrupt. It can 
use any of the process manipulation calls, and then use the UTFRK call 
to resume the suspended inferior process. 

Alternatively, the superior can simply decide to resume the inferior 
and allow it to execute the call. In this case, the next higher 
superior process monitoring the intercepted call receives an 
interrupt, and control is passed to that superior. If each superior 
process monitoring the call decides to resume the suspended process 
without changing its PC word, then the suspended process is allowed to 
execute the monitor call as it normally would. 

Note that an RTFRK should be performed when an interrupt is received, 
or the monitored process will not trap again. 

RESTRICTIONS: requires WHEEL, OPERATOR, or MAINTENANCE capability 
enabled for use on execute-only processes 

ACCEPTS IN AC1: function code in- the left half, and process handle in 
the right half 

AC2: software interrupt channel number in the left half, 
and size (in bits) of the monitor call bit table 

AC3: address of monitor call bit table 

RETURN +1: always 

The available functions are as follows: 

Code Symbol Meaning 

.TFSET Set monitor call intercepts for the given 

process. The calls that will be intercepted 
are indicated in the monitor call bit table. 
The given process must be frozen. This 
function is illegal for an execute-only 
process . 

1 .TFRAL Remove all monitor call intercepts for the 

given process. The process must be frozen. 
This function is illegal for an execute-only 
process . 

2 .TFRTP Remove for the given process only the monitor 

call intercepts that are indicated in the 
monitor call bit table. The given process 
must be frozen. This function is illegal for 
an execute-only process. 



3-461 



Code Symbol 

3 .TFSPS 

4 .TFRPS 

5 .TFTST 



TFRES 



7 .TFUUO 



10 .TFSJU 



11 .TFRUU 



TOPS-20 MONITOR CALLS 
(TFORK) 



Meaning 

Set the given software channel as the channel 
on which to generate the interrupt. 

Return in the left half of AC2 the software 
channel on which the interrupt will be 
generated . 

Test if the caller is to be intercepted when 
it attempts to execute monitor calls. On 
successful return AC2 contains -1 if it is to 
be intercepted or if it is not to be 
intercepted . 

Remove intercepts set for all inferiors and 
clear the software channel assigned to the 
interrupt for monitor call intercepts. 

Set monitor call intercepts for TOPS-10 
monitor calls (UUOs) for the given process. 
The process must be frozen. This function is 
illegal for an execute-only process. 

Set monitor call intercepts for both the 
calls indicated in the monitor call bit table 
and the TOPS-10 monitor calls. This function 
is a combination of functions .TFSET and 
.TFUUO. The given process must be frozen. 
This function is illegal for an execute-only 
process . 

Remove monitor call intercepts for the 
TOPS-10 monitor calls. The given process 
must be frozen. 



To set monitor call intercepts, the process must first issue .TFSPS 
(code 3). Then, .TFSET (code 0), .TFUUO (code 7) or .TFSJU (code 10) 
may be issued to set intercepts. 

The process handle in the right half of AC1 must refer to an inferior 
process or must be -4 to refer to all inferiors. When intercepts are 
set for a given process, they also apply to all processes inferior to 
the given process. When a process is created, it is subject to the 
same intercepts as the process that created it. 

If the software channel is given as 77, any intercepts bypass the 
given process without causing either an interrupt to its superior or a 
suspended state of the process. 

The monitor call bit table contains a bit for each of the TOPS-20 
monitor calls. When a bit in the table is on, the corresponding 
monitor call is to be intercepted when the given process attempts to 
execute it. If the bit is off, the corresponding monitor call will 
| not be intercepted. The size of the bit table is lOOO(octal) bits. 
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(TFORK) 



A process can remove only the intercepts it previously set; it cannot 
remove intercepts that other processes set. 

When the process being monitored attempts to execute the trapped-for 
JSYS, the process and its inferiors enter a suspended state. This 
suspended state differs from the normal "frozen" state of a process in 
the following ways: 

1. The inferiors of the monitored process are not frozen and 
continue to operate. 

2. The monitored process is resumed with the UTFRK monitor call. 
RFORK will not resume the process. 

3. All interrupts for the monitored process are queued and are 
acted upon immediately after the UTFRK monitor call. 

After the suspension of the monitored process, the superior process 
may do one of the following: 

1. Allow the monitored process to resume execution of the 
intercepted JSYS. 

2. Make changes in the working environment of the monitored 
process and allow that process to resume execution of the 
intercepted JSYS. 

3. Execute the intercepted JSYS on behalf of the monitored 
process, and then allow the monitored process to continue. 

The user interface to the monitor call intercept facility is provided 
for by three JSYS ' s : 



1. TFORK (trap) 

2. RTFRK (read) 

3. UTFRK (untrap) 



Generates an illegal instruction interrupt on error conditions below. 
TFORK ERROR MNEMONICS: 



FRKHX8 
TFRKX1 
TFRKX2 
TFRKX3 



Illegal to manipulate an execute-only process 
Invalid function code 

Unassigned process handle or not immediate inferior 
Process not frozen 
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(THIBR) 

THIBR JSYS 770 

Blocks the current process for the specified elapsed time or until 
awakened by a TWAKE monitor call, whichever occurs first. The THIBR 
call is a temporary call and may not be defined in future releases. 

ACCEPTS IN AC1: in the left half, and maximum number of seconds to 
block in the right half 

RETURNS +1: never 

+2: always, with time expired or TWAKE call occurred 
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TOPS- 20 MONITOR CALLS 
(TIME) 

TIME JSYS 14 

Returns the amount of time since the system was last 
restarted. 

RETURNS +1: always, with time (in milliseconds) right-justified 
in AC1, and divisor to convert the time to seconds in 
AC2. AC2 always contains 1000; thus, it is not 
necessary to examine its contents. 

This is a monotonically increasing number (when the system is running) 
independent of any resets of the time and date. 
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(TIMER) 

TIMER JSYS 522 

Controls the amount of time either a process within a job or the 
entire job can run. An interrupt is generated when the time has 
elapsed . 

Only one process in the job is allowed to time the entire job. If the 
job is already being timed, an error is given if another process 
attempts to time the job. An error is also given if a process other 
than the one that set the runtime limit of the job attempts to remove 
that limit. 

ACCEPTS IN AC1: process handle in the left half, and function code in 
the right half. 

AC2: time at which to generate an interrupt. Refer to the 
individual function descriptions for the specific 
arguments. 

AC3: number of the software channel on which to generate 
an interrupt when the time has expired. 

RETURNS +1: failure, error code in AC1 

+2: success 

The available functions are as follows: 

Code Symbol Meaning 

.TIMRT Specify the total runtime of the entire job. 

This function allows one process within a job 

to time the entire job. AC2 contains the 

total runtime in milliseconds that the job 

can accumulate before an interrupt is 

generated on the specified channel. If AC2 

contains 0, the limit on the runtime of the 
job is removed. The process handle given in 
AC1 must be . FHJOB (-5). 

1 .TIMEL Specify an elapsed time after which an 

interrupt is generated for the given process. 
AC2 contains the number of milliseconds that 
can now elapse before the interrupt is 
generated on the specified channel. 

2 .TIMDT Specify an exact time at which an interrupt 

is generated for the given process. AC2 
contains the internal format (refer to 
section 2.6.3) of the date and time when the 
interrupt is to be generated. 

3 .TIMDD Remove any pending interrupt requests that 

are to occur for the process at the given 
time. AC2 contains the internal format 
(refer to section 2.9.2) of the date and time 
of the interrupt request to be removed. AC3 
is not used for this function. 
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(TIMER) 



Code Symbol Meaning 

4 .TIMBF Remove any pending interrupt requests that 

are to occur for the process before the given 
time. AC2 contains the internal format 
(refer to section 2.9.2) of the date and 
time. AC3 is not used for this function. 

5 .TIMAL Remove all pending requests for the given 

process including the runtime limit on the 
entire job. AC3 is not used for this 
function. 

The runtime limit for a job can be obtained via the GETJI monitor call 
(contents of word .JIRT on return). If the job's time limit has been 
exceeded, the value returned by the GETJI call will be zero. 

TIMER ERROR MNEMONICS: 



TIMX1 
TIMX2 
TIMX3 
TIMX4 
TIMX5 
TIMX6 
TIMX7 
TIMX8 
TIMX9 
TIMX10 



Invalid function 

Invalid process handle 

Time limit already set 

Illegal to clear time limit 

Invalid software interrupt channel number 

Time has already passed 

No space available for a clock 

User clock allocation exceeded 

No such clock entry found 

No system date and time 
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TOPS-20 MONITOR CALLS 
(TLINK) 

TLINK JSYS 216 



Controls terminal linking, 
information. ) 
RESTRICTIONS : 



(Refer to Section 2.4.9.5 for more 



RETURNS 



AC2 
+ 1 
+ 2 



some functions require WHEEL or OPERATOR capability 
enabled 



ACCEPTS IN AC1: BO (TL%CRO) 



Clear link from remote to object 
designator. If the remote designator is 
-1, all remote links to the object 
designator are cleared. 

B1(TL%C0R) Clear link from object to remote 
designator. If the remote designator is 
-1, links from the object to all remote 
designators are cleared. 

B2(TL%E0R) Establish link from object to remote 
designator . 

B3(TL%ER0) Establish link from remote to object 
designator . 

B4(TL%SAB) Examine B5(TL%ABS) to determine the 
setting of the object designator's accept 
link bit. If this bit is off, B5 is 
ignored . 

B5(TL%ABS) Set the object designator's accept link 
bit. When B4 (TL%SAB) is on, the object 
designator is accepting links; if TL%ABS 
is off refusing links the object 
designator is. 

B6(TL%STA) Examine B7 (TL%AAD) to determine the 
setting of the object designator's accept 
advice bit. If this bit is off, B7 is 
ignored . 

B7(TL%AAD) Set the object designator's accept advice 
bit. When B6 (TL%STA) is on, the object 
designator is accepting advice if TL%AAD 
is on and refusing advice if TL%ADD is 
off. 



B18-B35 
(TL%OBJ) 



Object designator 



remote designator in the right half 
failure, error code in AC1 
success 



The object and remote designators must be either 4xxxxx or -1. An 

object designator of -1 indicates the controlling terminal. The 

following restrictions apply if the process does not: have WHEEL 
capability enabled: 

1. The object designator must specify this terminal. 
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2. The object-to-remote link must be specified before or at the 
same time as the remote-to-object link. 

If the accept bit of the remote designator is not set, a link from the 
object-to-remote designator causes the remote designator's bell to 
ring. If the remote designator does not set the accept bit within 15 
seconds, the TLINK call returns an error. 




DESX1: 
TLNKX1 
TLNKX2 
TLNKX3 
TTYX01 



Invalid source/destination designator 

Illegal to set remote to object before object to remote 

Link was not received within 15 seconds 

Links full 

Line is not active 
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TMON 



JSYS 7 



Returns various flags and parameters in the monitor's data base. In 
most cases, flag-oriented items return a 1 in AC2 if the flag is set 
and a in AC2 if the flag is cleared. In a few cases (noted in the 
text), flag-oriented items return the appropriate bit set or cleared 
in AC2. Value-oriented items return the value of the parameter in 
AC2. 



ACCEPTS IN AC1 



function code 



RETURNS +1: always, with value of the function in AC2 
The codes for the functions are as follows: 



Code Symbol 






.SFFAC 


1 


.SFCDE 


2 


•SFCDR 


3 


.SFMST 


4 


.SFRMT 


5 


.SFPTY 


6 


.SFCTY 


7 


.SFOPR 


10 


.SFLCL 


11 


.SFBTE 


12 


.SFCRD 


13 


.SFNVT 


21 


.SFUSG 


22 


.SFFLO 



23 


.SFMTA 


24 


.SFMSO 


25 


.SFMS1 


44 


•SFNTN 


45 


.SFNDU 


46 


.SFNHI 


47 


.SFTMZ 


50 


.SFLHN 


51 


.SFAVR 


52 


.SFSTS 


53 


.SFSOK 



are allowed. 



al lowed 



irectory 



RH20 backup 
is not to be 



RH2 
the 
or 



is at 
KL10-C 
KL10-E 



Meaning 

FACT file entries are allowed 

CHECKD found errors. 

CHECKD is running. 

Manual start is in progress. 

Remote LOGINS (dataset lines) 

PTY LOGINS are allowed. 

CTY LOGINS are allowed. 

Operator is in attendance. 

Local LOGINS (hardwired lines) are 

Bit table errors found on startup. 

Users can change nonpr ivileged 

parameters with the CRDIR monitor call 

ARPANET terminal LOGINS are allowed. 

USAGE file entries are allowed. 

Disk latency optimization using the 

register is enabled. This feature 

enabled unless the M8555 board of the 

Revision Level D AND either of 

processor is at Revision Level 10 

processor is at Revision Level 2. 

MOUNTR magtape allocation is enabled. 

System message level is set. 

System message level 1 is set. 

ARPANET is on. 

ARPANET will be reinitialized if it is down. 

ARPANET host table will be initialized. 

Local time zone 

ARPANET local host number 
Account validation is running on this system 
Status reporting is enabled. 
GETOK% defaults 



Required in AC2: GETOK% function code 

Returned in AC2: Flags , ,GETOK% function code 

Flags : 

Bit Symbol Meaning 

BO SF%EOK = Access checking is disabled 
1 = Access checking is enabled 

Bl SF%DOK = Access is denied if checking disabled 
1 = Access is allowed if checking disabled 
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Code Symbol 



TOPS-20 MONITOR CALLS 
(TMON) 

Meaning 

See the description of the GETOK% JSYS for GETOK* 
function codes. 



54 



SFMCY 



55 


.SFRDU 


56 


.SFACY 


57 


.SFRTW 


60 


.SFTDF 



Maximum offline expiration period in days in days 
for ordinary files (tape recycle period) . 
Read date update function data 

Maximum offline expiration period in days for 
archive files (tape recycle period) . 
File-retrieval requests that are waiting for the 
retrieval should fail rather than wait. 
Tape mount controls 



Flags 

Bit 

1B0 



Symbol 
MT%UUT 



Meaning 



unload unrecognizable 



Set = 
tapes 

Clear = treat unrecognizable 
tapes as unlabeled 
61 .SFWSP Enable working set preloading 

The SMON monitor call can be used to set various monitor flags. 

Generates an illegal instruction interrupt on error conditions below. 

TMON ERROR MNEMONICS: 

TMONX1: Invalid TMON function 
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(TTMSG) 

TTMSG JSYS 775 

Sends a message to a specified terminal or to all terminals. The 
TTMSG call is a temporary call and may not be defined in future 
releases . 

RESTRICTIONS: requires WHEEL or OPERATOR capability enabled to send 
to all terminals 

ACCEPTS IN AC1: 400000 + TTY number, or -1 to send to all terminals 

AC2: byte pointer to string in caller's address space to 
be sent 

RETURNS +1: always 

The TTMSG monitor call is a no-op if the specified terminal does not 
exist . 

Generates an illegal instruction interrupt on error conditions below. 

TTMSG ERROR MNEMONICS: 

GTDIX1: WHEEL or OPERATOR capability required 
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(TWAKE) 

TWAKE JSYS 771 

Wakes the specified job that is blocked because of the execution of a 
THIBR call. If more than one process in a job is blocked because of a 
THIBR call, execution of the TWAKE call causes any one of the 
processes to be awakened. The TWAKE call is a temporary call and may 
not be defined in future releases. 

ACCEPTS IN AC1: in the left half, and number of job to be awakened 
in the right half 

RETURNS +1: failure, error code in AC1 

+2: success, signal sent. Job will be awakened 
immediately if blocked by a THIBR call or as soon as 
next THIBR call is executed. 

TWAKE ERROR MNEMONICS: 

ATACX1: Invalid job number 
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(UFPGS) 



UFPGS JSYS 525 



Updates pages of the specified file. This monitor call is used to 
guarantee that a certain sequence of file pages has been written to 
the disk before any other operation is performed. 

ACCEPTS IN AC1: JFN in the left half, and file page number of the 
first page to be updated in the right half 

AC2: flags,, count of number of sequential pages to update 

RETURNS +1: failure, error code in AC1 

+2: success, all modified pages are written to disk. The 
FDB is updated, if necessary. 



FLAGS: 

Bit Symbol Meaning 

UF%NOW Allows performing a UFPGS call without 
blocking. The JSYS will not block even if some 
pages need to be written to disk. 

If UF%NOW is not set, the UFPGS call causes the process to block until 
all writes to the disk are completed. 

UFPGS ERROR MNEMONICS: 

UFPGXl: File is not opened for write 

DESX3: JFN is not assigned 

DESX4: Invalid use of terminal designator or string pointer 

DESX7: Illegal use of parse-only JFN or output wildcard-designators 

DESX8: File is not on disk 

LNGFX1: Page table does not exist and file not open for write 

10X11: Quota exceeded 

10X34: Disk full 

10X35: Unable to allocate disk - structure damaged 
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TOPS-20 MONITOR CALLS 
(USAGE) 

USAGE JSYS 564 



Controls accounting on the system by writing entries into the system's 
data file. All entries to the data file are made with this call. 
Examples of the types of entries entered into the data file are disk 
storage usage for regulated structures, input and output spooler 
usage, job session entry, and date and time changes. 

The file written by the USAGE call is an intermediate binary file, 
which is converted by a system program to the final ASCII file. Each 
entry in the final file is at least two records long, each record 
being defined as a string of ASCII characters terminated with a 
line-feed character. The first record contains system and file 
information; its format is the same for all entries. Subsequent 
records contain data pertaining to the entry; their formats vary 
according to the particular data being entered. 



Refer to the USAGE File Specification for additional 
the system's data file. 



information on 



RESTRICTIONS: 



ACCEPTS IN AC1 



AC2: 



requires WHEEL or OPERATOR capability enabled 

function code 

function argument or address of record descriptor 
block 



RETURNS +1: always 

The available functions are as follows: 

Code Symbol Meaning 

.USENT Write an entry into the system's data file. 

AC2 contains the address of the record 
descriptor block. 

1 .USCLS Close the system's data file, which is named 

PS:<ACCOUNTS>SYSTEM-DATA.BIN. No additional 

entries are recorded into this file, and a new 

SYSTEM-DATA.BIN is opened for subsequent 
entries . 



.USCKP 



.USLGI 



Perform a checkpoint of all jobs. Data 
recorded during a checkpoint includes the 
billable data (connect time and runtime, for 
example) accumulated during the job session. 
The session starts from time of login or the 
last SET ACCOUNT command, and ends at the time 
this function is performed. The data collected 
on a LOGIN or SET ACCOUNT command is entered 
into the session entry in the data file. The 
default checkpoint interval is 10 minutes. 

Initialize a checkpoint entry for the job. 
This function is used internally by the LOGIN 
monitor call.. AC2 contains the address of the 
record descriptor block. 
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(USAGE) 

Code Symbol Meaning 

4 .USLGO Terminate the checkpoint entry for the job and 

write an entry into the system's data file, 
which is named PS : <ACCOUNTS>SYSTEM-DATA.BIN. 
This function is used internally by the LGOUT 
monitor call. AC2 contains the address of the 
record descriptor block. 

5 .USSEN Terminate the current session, write an entry 

into the system's data file, which is named 
PS:<ACCOUNTS>SYSTEM-DATA.BIN, and initialize a 
new checkpoint entry for the job. This 
function is used internally by the CACCT 
monitor call. AC2 contains the address of the 
record descriptor block. 

6 .USCKI Set the checkpoint time interval. AC2 contains 

the interval in minutes. 

7 .USENA Install the accounting data base from the file 

named PS : <SYSTEM>ACCOUNTS-TABLE. BIN into the 
running monitor. The ACTGEN program uses this 
file to generate the list of valid accounts. 

10 .USCAS Change accounting shift. This function will 

perform a "session end" function for every 
active job. 

11 .USSAS Set accounting shifts. Sets the times when 

automatic accounting shift changes are to 

occur. This function takes an argument in AC2 

which is a pointer to a block of the following 
format : 

table header 

table entry 



table entry 

The table header word contains the number of 
actual entries in the table in the left 
halfword, and the maximum number of table 
entries in the right halfword. Each table 
entry is one word in the following format: 

B0-B6 US%DOW Days of the week 
that this entry is in 
effect. Bit n is set if 
this entry is in effect 
for day n (0 = Monday) . 

B7-B17 Unused, must be zero. 

B18-B35 US%SSM Time of day that 
automatic shift change 
should occur. Time is 
specified in seconds since 
midnight . 

The maximum number of table entries is 100 
decimal . 
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(USAGE) 



Code Symbol Meaning 

12 .USRAS Read accounting shifts. This function returns 
the times of the automatic shift changes that 
were set with .USSAS. AC2 contains the address 
of an argument block that is filled in by this 
function. The block has the same format as the 
.USSAS block. Note that the right halfword 
(maximum size) of the table header must be 
specified by the user for .USFAS. 

The record descriptor block, whose address is given in AC2, is set up 
by the UITEM. macro defined in ACTSYM.MAC. (Refer to Appendix D for 
the definition of the UITEM. macro.) The names of all data entries 
are generated by this macro. The USENT. macro is used to generate the 
header of the record descriptor block. 

The format of the data generated by the USAGE call is a list of items 
describing the entries in a single record. This list has a header 
word containing the version numbers and the type of entry. The data 
words follow this header with two words per data item. The list is 
terminated with a zero word. 

Generates an illegal instruction interrupt on error conditions below. 

USAGE ERROR MNEMONICS: 

CAPX1: WHEEL or OPERATOR capability required 

ARGX02: Invalid function 

ARGX04: Argument block too small 

ARGX05: Argument block too long 

USGX01: Invalid USAGE entry type code 

USGX02: Item not found in argument list 

USGX03: Default item not allowed 
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(USRIO) 

USRIO JSYS 310 

Places the user program into user I/O mode in order that it can 
execute various hardware I/O instructions. The user IOT flag is 
turned on in the PC of the running process. The program can leave 
user I/O mode by executing a JRSTF with a PC in which bit 6 is zero 
(e.g. , JRSTF @ [ .+1] ) . 

RESTRICTIONS: requires WHEEL or OPERATOR capability enabled 

RETURNS +1: failure, error code in AC1 

+2: success, user IOT flag is set 

USRIO ERROR MNEMONICS: 

CAPX2: WHEEL, OPERATOR, or MAINTENANCE capability required 
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(UTEST) 

UTEST JSYS 563 



Provides a method for determining if every instruction in a section of 
monitor code actually gets executed. This monitor call does not test 
the code by executing it; it confirms that a test of the code is 
complete by reporting the instructions that were executed during the 
test . 



RESTRICTIONS: 
ACCEPTS IN AC1 



requires WHEEL or OPERATOR capability enabled 

function code in the left half, and length of the 
argument block in the right half. 



AC2: address of the argument block 
RETURNS +1: always 
The available functions are as follows: 

Code Symbol Meaning 

.UTSET Start testing of the code. 

1 .UTCLR Stop testing of the code and update the bit map 

in the argument block. 

The format of the argument block is as follows: 

Meaning 

Address of the beginning of the section of code 
that is to be tested. 

Length of section of code that is to be tested. 

Start of bit map representing the instructions 
that are to be tested in the section of code. 
This map contains one bit for each location in 
the section. If a bit is on in the map, the 
corresponding instruction is to be tested. If 
a bit is off, the corresponding instruction is 
not to be tested. 

Locations that contain data and that would 
cause the section of code to execute improperly 
if that data were changed should not be tested. 



Word 


Symbol 





.UTADR 


1 


.UTLEN 


2 


.UTMAP 



Internally, a copy of the code being tested is placed in a buffer, 

which is dynamically locked down during execution of the UTEST call. 

The system allows any monitor routine to be tested as long as a 

pushdown stack to which AC P (AC17) points is set up whenever the 
routine is called. 

After execution of the .UTCLR function, the bit map is changed to 
reflect the instructions that were actually executed during the test. 
If a bit is on in the map, the corresponding instruction was executed. 
If a bit is off, the corresponding instruction was not executed. 
Generates an illegal instruction interrupt on error conditions below. 
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UTEST ERROR MNEMONICS: 

CAPX3: WHEEL capability required 

UTSTX1: Invalid function code 

UTSTX2: Area of code too large to test 

UTSTX3: UTEST facility in use by another process 



3-480 



TOPS-20 MONITOR CALLS 
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UTFRK JSYS 323 



Resumes the executi 
monitor call inte 
depends on the curr 
the suspended pro 
handling the interc 
call) . Then on 
continues at the n 
intercept does no 
the next superior p 
will receive the in 



on of a proce 
rcept. The i 
ent PC word o 
cess from ex 
ept can chang 
execution of 
ew PC. If 
t change the 
rocess interc 
terrupt . 



ss that is suspended 
nstruction where the e 
f the suspended proces 
ecuting the call, the 
e the PC word (via the 
the UTFRK call, the s 
the superior proces 
PC word of the suspend 
epting that particula 



because of a 
xecution resumes 
s. To prevent 
superior process 
SFORK or SFRKV 
uspended process 
s handling the 
ed process, then 
r monitor call 



See the description of the TFORK JSYS for more information on the 
monitor call intercept facility. 

ACCEPTS IN AC1: flag bits in the left half, and process handle in the 
right half 

RETURNS +1: always 

The flag bit that can be given in AC1 is as follows: 

Bit Symbol Meaning 

UT%TRP Cause a failure return for the suspended 
process. This return will be either the 
generation of an illegal instruction interrupt 
or the processing of an ERJMP or ERCAL 
instruction. 

The UTFRK monitor call is a no-op if 

1. The process handle given is valid but the process specified 
is not suspended because of a monitor call intercept. 

2. The caller is not one of the processes monitoring the 
suspended process and therefore is not permitted to resume 
the process. 



Generates an illegal instruction interrupt on error conditions below. 
UTFRK ERROR MNEMONICS: 



FRKHXl 
FRKHX2 
FRKHX3 
FRKHX8 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 

Illegal, to manipulate an execute-only process 
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(VACCT) 



VACCT JSYS 566 



Verifies accounts by validating the supplied account for the given 
user . 

ACCEPTS IN AC1: 36-bit user number, 36-bit directory number, or -1 to 
validate the account for the current user 

AC2: byte pointer to account string 

RETURNS +1: always, with updated pointer in AC2 

Generates an illegal instruction interrupt on error conditions below. 

VACCT ERROR MNEMONICS: 



VACCXO 
VACCX1 
VACCX2 
MONX02 
DELFX6 
DIRX1: 
DIRX3: 
STRX01 
OPNX9: 
OPNX16 



Invalid account 

Account string exceeds 39 characters 

Account has expired 

Insufficient system resources (JSB full) 

Internal format of directory is incorrect 

Invalid directory number 

Internal format of directory is incorrect 

Structure is not mounted 

Invalid simultaneous access 

File has bad index block 
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(WAIT) 

WAIT JSYS 306 

Dismisses the current process indefinitely and does not return. If 
the software interrupt system is enabled for this process, the process 
can be interrupted out of the wait state. Upon execution of a DEBRK 
call, the process continues to wait until the next interrupt unless 
the interrupt routine changes the PC word. In this case, the process 
resumes execution at the new PC location. If the interrupt routine 
changes the PC word, it must set the user-mode bit (bit 5) of the PC 
word. (Refer to Section 2.6.7.) 
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(WFORK) 

WFORK JSYS 163 

Causes the current process to wait for an inferior process to 

terminate (voluntarily or involuntarily). A process is considered 

terminated if its state is either .RFHLT or .RFFPT (refer to RFSTS 
JSYS for a description of process status) . 

ACCEPTS IN AC1: inferior process handle, or -4 in the right half to 
wait for any one of the inferior processes to 
terminate 

RETURNS +1: always, when one of the specified processes 
terminates 

This call returns immediately if the specified process or one of the 
inferior processes has already terminated. 

Generates an illegal instruction interrupt on error conditions below. 

WFORK ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 
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(WILD%) 

WILD% JSYS 565 



Compares a possibly wild string (one containing wild-card characters) 
against a non-wild string to see if the latter matches the wild 
string. For example, "AND" would be a legal match for the wild string 
"A*D". Likewise "AND" would be a legal match for the wild string 
"A%%". The WILD% JSYS will also compare a possibly wild file 
specification with a non-wild file specification. (See Section 2.2.3 
for a description of wild-card characters.) 



ACCEPTS IN AC1 
AC2 
AC3 



flags in the left half, function in the right half 
wild argument - JFN or byte pointer to string 
non-wild argument - JFN or byte pointer to string 



RETURNS 



+1 : always, with information returned in AC1. 



The available functions are as follows 



Code 




Symbol 
.WLSTR 



Meaning 



Compare a non-wild string against a wild 
string. AC2 contains a byte pointer to a wild 
string and AC3 contains a byte pointer to a 
non-wild string. By default, the comparison is 
made without regard to what kind of characters 
the strings contain. Thus tabs, spaces, and 
carriage returns, for example, are treated just 
as letters are. The following flag can be set 
in AC1: 



BO (WL%LCD) 



Lower case characters are to be 
treated as distinct from upper 
case letters. If this bit is not 
set, a lower case character will 
match the corresponding upper 
case character. 



On return, AC1 contains zero if a match 
occurred, or the following flags if no match 
occurred : 

BO (WL%NOM) If set, this bit indicates that 
the non-wild string did not match 
the wild string. 

B1(WL%ABR) If set, this bit indicates that 
the non-wild string is not 
matched, but is an abbreviation 
of the wild string. If this bit 
is set, it implies that bit 
WL%NOM is also set. 
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(WILD%) 

Code Symbol Meaning 

1 .WLJFN Compare a non-wild file specification against a 
wild file specification. AC2 contains a JFN 
with flags (as returned by GTJFN) for the wild 
file and AC3 contains a JFN (without flags) for 
the non-wild file. On return, AC1 contains 
zero if a match occurred. Otherwise, the 
following flags are returned (in AC1) to 
indicate which parts of the file specification 
do not match: 

Bl (WL%DEV) Device field does not match 

B2(WL%DIR) Directory field does not match 

B3(WL%NAM) Name field does not match 

B4(WL%EXT) File type does not match 

B5(WL%GEN) Generation number does not match 

If a parse-only JFN is given (see section 2.2.3), and one of the 
fields is not specified (such as a file name) , that field will be 
treated as a null field. Thus the filenames PS : <DBELL>FOO. BAR. 3 and 
PS:<DBELL>.BAR. 3 will not match. 

WILD% ERROR MNEMONICS: 

DESX3: JFN is not assigned 

RDTX1: Invalid string pointer 

ARGX02: Invalid function 

ARGX22: Invalid flags 
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(XGSEV%) 

XGSEV% JSYS 614 

Gets an extended special entry vector that has been set to allow use 
of TOPS-10 Compatibility and RMS entry vectors in non-zero sections. 

ACCEPTS IN AC1: vector type code,, fork handle 

RETURNS +1: always, with length of entry vector in AC2, and flags 
in bits 0-5 of AC3 , address of entry vector in bits 
6-35 of AC3. 

Generates an illegal instruction trap on error return. 

See XSSEV% for a list of vector type codes. 

Flags returned in bits 0-5 of AC3 are the same as those listed for 
XSSEV%. 

XGSEV% ERROR MNEMONICS 
XSEVX1: Illegal vector type 
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TOPS-20 MONITOR CALLS 
(XGTPW%) 

XGTPW% JSYS 612 



Returns the page-fail words. This monitor call allows a program to 
retrieve information about a previous page-fail trap. 



ACCEPTS IN AC.1 
AC2 



RETURNS 



+ 1 



process handle 

address of block in which to return data. The first 
word of the data block must contain, the number of 
words in the argument block. The other words of the 
data block should contain zero. 

always, with page-fail data returned in the data 
block 



The data block has the following format 





Length 


of 


the 


data bloc 


k , inclu 


ding 


th 


is 


wor 


d 


pag 


e-f ail 


flc 


igs 


i 


















Adc 


Iress that ref 


erenced 


the 


pag 


e 






MUUO 


opcode & 


AC 


i 
















j 


30- 


-bit 


Effective 


address 


of 


the 


MUUO 





BO (PF%USR) page failure on a user-mode reference 
B1(PF%WTF) page failure on a write reference 

This information allows a program to determine the exact cause of a 
memory trap and the effective virtual address that caused the trap. 
This information is sufficient to enable the program to continue, if 
desired, when the cause of the trap has been removed. 

Generates an illegal instruction interrupt on error conditions below. 

GTRPW ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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(XGVEC%) 

XGVEC% JSYS 606 

Returns the entry vector of the specified process. The process can be 
one that runs in one or more sections of memory. (Refer to Section 
2.7.3.) 

ACCEPTS IN AC1: process handle 

RETURNS +1: always, with length of the entry vector in AC2, 
address of the entry vector in AC3 

The XSVEC% monitor call can be used to set the entry vector of a 
process that runs in one or more sections of memory. 

Generates an illegal instruction interrupt on the following error 
conditions : 

XGVEC% ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 



Invalid process handle 

Illegal to manipulate a superior process 

Invalid use of multiple process handle 
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TOPS-20 MONITOR CALLS 
(XRIR%) 

XRIR% JSYS 601 



Reads the addresses of the channel and priority level tables for the 
specified process. (Refer to Section 2.6.3.) These addresses must be 
set with the XSIR% monitor call. 



ACCEPTS IN AC1: process handle 

AC2: address at which to begin the argument block 

RETURNS +1: always. The argument block contains the information 
stored in the Process Storage Block. 

The format of the returned argument block is as follows: 



Length of the argument block, including this word 
Address of the interrupt level table 
Address of the channel table 



To see the format of the channel and interrupt level tables, refer to 
Section 2.6.3. 
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TOPS-20 MONITOR CALLS 
(XRMAP%) 

XRMAP% JSYS 611 



Acquires a handle on a page in a process to determine the access 
allowed for that page. 

ACCEPTS IN AC1: process handle in the left half, and zero in the 
right half 

AC2: address of the argument block 

RETURNS +1: always, with a handle on the page in word 1 of the 

returned data block, and access information in word 

2. The handle in word 1 is a process/file designator 
in the left half and a page number in the right half. 

The argument block addressed by AC2 has the following format: 



Le 


ng 


th of the < 


argument block, 


inc 


luding 


this wor 


d 






number 


of 


pages 


on 


which 


to 


return 


data 








number 


of 


the f 


Lrst page 


in 


this g 


roup 








address 


at 


which 


to 


return th 


e data 


block 





number of pages in this group on which to return data 

number of the first page in this group 

address at which to return the data block 



The number of words in the argument block is three times the number of 
groups of pages for which you want access data, plus one. Each group 
of pages requires three arguments: the number of pages in the group, 
the number of the first page in the group, and the address at which 
the monitor is to return the access data. 

Note that the address to which the monitor returns data should be in a 
section of memory that already exists. 

The access information returned for each group of pages specified in 
the argument block is the following: 

B2(RM%RD) read access allowed 

B3 (RM%WR) write access allowed 

B4(RM%EX) execute access allowed 

B5(RM%PEX) page exists 

B9 (RM%CPY) ccpy-on-wr ite access 

XRMAP% returns a -1 for each page specified in the argument block that 
does not exist. It also returns a zero flag word for each such page. 

Generates an illegal instruction interrupt on error conditions below. 
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TOPS-20 MONITOR CALLS 
(XRMAP%) 



XRMAP% ERROR MNEMONICS: 

FPKHX1: Invalid process handle 

ARGX17: Invalid argument block length 
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TOPS-20 MONITOR CALLS 
(XSFRK%) 

XSFRK% JSYS 605 



Starts the specified process in a non-zero section of memory. If the 
process is frozen, the XSFRK% call changes the PC but does not resume 
the process. The RFORK call must be used to resume execution of the 
process . 



ACCEPTS IN AC1 



RETURNS 



AC2 

AC3 

+ 1 



f lags ,, process handle 

Flags : 

SF%CON(1BO) 



continue a process that has halted. 

If SF%CON is set, the address in AC3 

is ignored and the process continues 

from where it was halted. 



PC flags in the left half, in the right half 
address to which this call is to set the PC 
always 



The SFRKV monitor call can be used to start a process at a given 
position in its entry vector. 

Generates an illegal instruction interrupt on error conditions below. 

XSFRK% ERROR MNEMONICS: 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 

FRKHX5: Process has not been started 

FRKHX8: Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(XSIR%) 

XSIR% JSYS 602 



Sets the addresses of the channel and priority level tables for the 
specified process. (Refer to Section 2.6.3.) This process can run in 
one or more sections of memory. 



ACCEPTS IN AC1 

AC2 

RETURNS +1 



process handle 

address of the argument block 

always. The addresses in the argument block are 
stored in the Process Storage Block. 



The format of the argument block is as follows 



Length of the argument block, including this word 



Address of the interrupt level table 
Address of the channel table 



To see the format of the channel and interrupt level tables, refer to 
Section 2.6.3. 

If the contents of the tables are changed after execution of the XSIR% 
call, the new contents will be used on the next interrupt. 

The XRIR% monitor call can be used to obtain the table addresses set 
with the XSIR% monitor call. 

Generates an illegal instruction interrupt on error conditions below. 

XSIR% ERROR MNEMONICS: 

ARGX04: Argument block too small 

ARGX05: Argument block too long 

SIRX1: Table address is not greater than 20 

XSIRX2: Level table crosses section boundary 

FRKHX1: Invalid process handle 

FRKHX2: Illegal to manipulate a superior process 

FRKHX3: Invalid use of multiple process handle 

FRKHX8: Illegal to manipulate an execute-only process 
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TOPS-20 MONITOR CALLS 
(XSSEV%) 

XSSEV% JSYS 613 

Allows setting of extended special entry vector for use with TOPS-10 
Compatibility and RMS entry vectors in non-zero sections. 

ACCEPTS IN AC1: vector type code,, fork handle 

AC2: length of entry vector 

AC3: flags in bits 0-5, address of entry vector in bits 
6-35 

RETURNS +1: always 

In order to be called from any section, the called program must 
provide extended format PC and UUO words. A flag in the call 
specifies whether the program expects new or old format words. Old 
format words should only be used for old versions of the program still 
running in Section 0. 

The vector type codes supplied in the left half of AC1 are as follows: 

Code Symbol Meaning 

.XSEVC TOPS-10 Compatibility 

1 .XSEVD RMS 

The flags set in bits 0-5 of AC3 are: 

Flag Symbol Meaning 

Bl XS%EEV Extended entry vector. If this bit is on, 

the entry vector points to a 2-word extended 
PC and to an extended format UUO word. If 
this bit is off, the entry vector points to 
old format PC and UUO words. 

XSSEV% ERROR MNEMONICS: 

XSEVX1: Illegal entry vector type 

XSEVX2: Invalid entry vector length 
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TOPS-20 MONITOR CALLS 
(XSVEC%) 

XSVEC% JSYS 607 



Sets or clears the entry vector of the specified process.. The process 
can be one that runs in one or more sections of memory. (Refer to 
Section 2.7.3.) 



ACCEPTS IN AC1 
AC2 
AC3 

RETURNS +1 



process handle 

length of the entry vector, or 

address at which the entry vector starts 

always 



A zero in AC2 clears the process entry vector. 

The XGVEC% monitor call can be used to obtain the entry vector of the 
process . 

Generates an illegal instruction interrupt on error conditions below. 

XSVEC% ERROR MNEMONICS: 



FRKHX1 
FRKHX2 
FRKHX3 
FRKHX8 
S EVE XI 



Invalid process handle 

Illegal to manipulate superior process 
Invalid use of multiple process handle 
Illegal to manipulate an execute-only process 
Entry vector length is not less than 1000 
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APPENDIX A 
ASCII, SIXBIT, AND EBCDIC COLLATING SEQUENCES AND CONVERSIONS 



Table A-l shows the ASCII and SIXBIT collating sequences and the 

conversions from ASCII to EBCDIC. If the ASCII character does not 

convert to the same character in EBCDIC, the EBCDIC character is shown 

in parentheses next to the EBCDIC code. Note that the first and last 

32 characters do not exist in SIXBIT. Also, the characters in the 
first column of page A-l (NUL, SOH, STX, and so forth) are control 
characters, which are nonprinting. 

Table A-l 
ASCII and SIXBIT Collating Sequence and Conversion to EBCDIC 





ASCII 


EBCDIC 






ASCII 


EBCDIC 


Character 


7-bit 


9-bit 




Character 


SIXBIT 


7-bit 


9-bit 


NUL 


000 


000 




Space 


00 


040 


100 


SOH 


001 


001* 




i 


01 


041 


132 


STX 


002 


002* 




H 


02 


042 


177 


ETX 


003 


003* 




# 


03 


043 


173 


EOT 


004 


067 




$ 


04 


044 


133 


ENO 


005 


055* 




% 


05 


045 


154 


ACK 


006 


056* 




& 


06 


046 


120 


BEL 


007 


057* 




i 


07 


047 


175 


BS 


010 


026 




( 


10 


050 


115 


HT 


011 


005 




) 


11 


051 


135 


LF 


012 


045 




* 


12 


052 


134 


VT 


013 


013* 




+ 


13 


053 


116 


FF 


014 


014* 




/ 


14 


054 


153 


CR 


015 


025* 


NL) 


- 


15 


055 


140 


SO 


016 


006* 


LC) 


. 


16 


056 


113 


SI 


017 


066* 


UC) 


/ 


17 


057 


141 


DLE 


020 


044* 


BYP) 





20 


060 


360 


DC1 


021 


024* 


RES) 


1 


21 


061 


361 


DC2 


022 


064* 


PN) 


2 


22 


062 


362 


DC 3 


023 


065* 


RS) 


3 


23 


063 


363 


DC 4 


024 


004* 


PF) 


4 


24 


064 


364 


NAK 


025 


075* 




5 


25 


065 


365 


SYN 


026 


027* 


IL) 


6 


26 


066 


366 


ETB 


027 


046* 


EOB) 


7 


27 


067 


367 


CAN 


030 


052* 


CM) 


8 


30 


070 


370 


EM 


031 


031* 




9 


31 


071 


3 71 


SUB 


032 


032* 


CC) 


: 


32 


072 


172 


ESC 


033 


047* 


PRE) 


/ 


33 


073 


136 


FS 


034 


023* 


TM) 


< 


34 


074 


114 


GS 


035 


041* 


SOS) 


= 


35 


075 


176 


RS 


036 


040* 


DS) 


> 


36 


076 


156 


US 


037 


042* 


FS) 


p 


37 


077 


157 
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ASCII, SIXBIT, AND EBCDIC COLLATING SEQUENCES AND CONVERSIONS 



Table A-l (Cont.) 
ASCII and SIXBIT Collating Sequence and Conversion to EBCDIC 



ASCII EBCDIC 
Character SIXBIT 7-bit 9-bit 



ASCII EBCDIC 
Character 7-bit 9-bit 



@ 


40 


100 


174 


# 


140 


171 


A 


41 


101 


301 


a 


141 


201 


B 


42 


102 


302 


b 


142 


202 


C 


43 


103 


303 


c 


143 


203 


D 


44 


104 


304 


d 


144 


204 


E 


45 


105 


305 


e 


145 


205 


F 


46 


106 


306 


f 


146 


206 


G 


47 


107 


307 


g 


147 


207 


H 


50 


110 


310 


h 


150 


210 


I 


51 


111 


311 


i 


151 


211 


J 


52 


112 


321 


J 


152 


221 


K 


53 


113 


3 22 


k 


153 


222 


L 


54 


114 


323 


1 


154 


223 


M 


55 


115 


324 


m 


155 


224 


N 


56 


116 


325 


n 


156 


225 





57 


117 


326 


o 


157 


226 


P 


60 


120 


327 


P 


160 


227 


Q 


61 


121 


330 


q 


161 


230 


R 


62 


122 


331 


r 


162 


231 


S 


63 


123 


342 


s 


163 


242 


T 


64 


124 


343 


t 


164 


243 


U 


65 


125 


344 


u 


165 


244 


V 


66 


126 


345 


V 


166 


245 


W 


67 


127 


346 


w 


167 


246 


X 


70 


130 


347 


X 


170 


247 


Y 


71 


131 


350 


y 


171 


250 


Z 


72 


132 


351 


z 


172 


251 


[ 


73 


133 


2551 


{ 


173 


300 i 


\ 


74 


134 


340 


1 


174 


117 


] 


75 


135 


27 5 


} 


175 


320 


^ 


76 


136 


137 


~ 


176 


241 


- 


77 


137 


155 


Delete 


177 


007 



1 These EBCDIC codes either have no equivalent in the ASCII or SIXBIT 

character sets, or are referred to by different names. They are 

converted to the indicated ASCII characters to preserve their 

uniqueness if the ASCII character is converted back to EBCDIC. 



A-2 



ASCII, SIXBIT, AND EBCDIC COLLATING SEQUENCES AND CONVERSIONS 



Table A-2 shows the EBCDIC collating sequence and the conversion 
EBCDIC to ASCII. 



from 



Table A-2 
EBCDIC Collating Sequence and Conversion to ASCII 



EBDIC 


EBCDIC 


ASCII 


ASCII 


EBCDIC 


EBCDIC 


ASCII 


ASCII 


code 


character 


code 


character 


code 


character 


code 


character 


000 


NUL 


000 


NUL 


050 




134 


\ 


001 


SOH 


001 


SOH 


051 




134 


\ 


002 


STX 


002 


STX 


052 


SM 


030 


CAN 


003 


ETX 


003 


ETX 


053 


CUZ 


134 


\ 


004 


PF 


024 


DC4 


054 




134 


\ 


005 


HT 


011 


HT 


055 


ENQ 


005 


ENQ 


006 


LC 


016 


SO 


056 


ACK 


006 


ACK 


007 


Delete 


1.77 


Delete 


057 


BEL 


007 


BEL 


010 




134 


\ 


060 




134 


\ 


011 




134 


\ 


061 




134 


\ 


012 


SMM 


134 


\ 


-62 




134 


\ 


013 


VT 


013 


VT 


063 




134 


\ 


014 


FF 


014 


FF 


064 


PN 


022 


DC2 


015 


CR 


134 


\ 


065 


RS 


023 


DC3 


016 


SO 


134 


\ 


066 


UC 


017 


SI 


017 


SI 


134 


\ 


067 


EOT 


004 


EOT 


020 


DLE 


134 


\ 


070 




134 


\ 


021 


DC1 


134 


\ 


071 




134 


\ 


022 


DC 2 


134 


\ 


072 




134 


\ 


023 


TM 


034 


FS 


073 




134 


\ 


024 


RES 


021 


DC1 


074 


CU3 


134 


\ 


025 


NL 


015 


CR 


075 


DC4 


025 


NAK 


026 


BS 


010 


BS 


076 


NAK 


134 


\ 


027 


IL 


026 


SYN 


077 


SUB 


134 


\ 


030 


CAN 


134 


\ 


100 


Space 


040 


Space 


031 


EM 


031 


EM 


101 




134 


\ 


032 


CC 


032 


SUB 


102 




134 


\ 


033 


CU1 


134 


\ 


103 




134 


\ 


034 


IFS 


134 


\ 


104 




134 


\ 


035 


IGS 


134 


\ 


105 




134 


\ 


036 


IRS 


134 


\ 


106 




134 


\ 


037 


IUS 


134 


\ 


107 




134 


\ 


040 


DS 


036 


PS 


110 




134 


\ 


041 


SOS 


03 5 


GS 


111 




134 


\ 


042 


FS 


037 


US 


112 


CENT 


134 


\ 


043 




134 


\ 


113 


. 


056 


. 


044 


BYP 


020 


DLE 


114 


< 


074 


< 


045 


LF 


012 


LF 


115 


( 


050 


( 


046 


ETB 


027 


ETB 


116 


+ 


053 


+ 


047 


ESC 


033 


ESC 


1.17 


1 


174 


| 
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ASCII, SIXBIT, AND EBCDIC COLLATING SEQUENCES AND CONVERSIONS 



Table A-2 (Cont.) 
EBCDIC Collating Sequence and Conversion to ASCII 



EECDIC 


EBCDIC 


ASCII 


ASCII 


EBCDIC 


EBCDIC 


ASCII 


ASCII 


code 


character 


code 


character 


code 


character 


code 


character 


120 


& 


046 


& 


170 




134 


\ 


121 




13 4 


\ 


171 




140 




122 




134 


\ 


172 


: 


072 


: 


123 




134 


\ 


173 


# 


043 


# 


124 




134 


\ 

\ 


174 


@ 


1.00 


@ 


125 




134 


\ 
\ 


175 


t 


47 


i 


126 




134 


\ 
\ 


176 


= 


75 


= 


127 




134 


\ 
\ 


177 


M 


042 


ii 


130 




134 


\ 
\ 


200 




134 


\ 


131 




134 


\ 


201 


a 


141 


a 


132 


i 


041 


1 


202 


b 


142 


b 


133 


$ 


044 


S 


203 


c 


143 


c 


134 


* 


052 


* 


204 


d 


144 


d 


135 


I 


051 




205 


e 


145 


e 


136 




073 




206 


f 


146 


f 


137 




137 


\ 

\ 


207 


g 


147 


g 


140 


- 


055 


- 


210 


h 


150 


h 


141 


\ 


057 


/ 

/ 


211 


i 


15 1 


i 


142 




134 


\ 

\ 


212 




134 


\ 


143 




134 


\ 


213 




134 


\ 


144 




134 


\ 


214 




134 


\ 


145 




134 


\ 


215 




134 


\ 


146 




134 


\ 


216 




134 


\ 


147 




134 


\ 


217 




134 


\ 


150 




134 


\ 


220 




134 


\ 


151 




134 


\ 


221 


j 


152 


j 


152 




134 


\ 


222 


k 


153 


k 


153 


i 


054 


r 


223 


1 


154 


1 


154 


% 


045 


c. 


224 


m 


155 


m 


155 




137 




225 


n 


156 


n 


156 


> 


076 


> 


226 


o 


157 


o 


157 


? 


077 


■p 


227 


P 


160 


P 


160 




134 


\ 


230 


q 


161 


q 


161 




134 


\ 


231 


r 


162 


r 


162 




134 


\ 


232 




13 4 


\ 


163 




134 


\ 


233 




134 


\ 


164 




134 


\ 


234 




134 


\ 


165 




134 


\ 


235 




134 


\ 


166 




134 


\. 


236 




134 


\ 


167 




134 


\ 


237 




134 


\ 
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ASCII, SIXBIT, AND EBCDIC COLLATING SEQUENCES AND CONVERSIONS 



Table A-2 (Cont.) 
EBCDIC Collating Sequence and Conversion to ASCII 



EBCDIC 


EBCDIC 


ASCII 


ASCII 


EBCDIC 


EBCDIC 


ASCII 


ASCII 


code 


character 


code 


character 


code 


character 


code 


character 


240 




134 


\ 


310 


H 


110 


H 


241 




176 


~ 


311 


I 


110 


I 


242 


s 


163 


s 


312 




134 


\ 


243 


t 


164 


t 


313 




134 


\ 


244 


u 


165 


u 


314 




134 


\ 


245 


V 


166 


V 


315 




134 


\ 


246 


w 


16 7 


w 


316 




134 


\ 


247 


X 


170 


X 


317 




134 


\ 


250 


y 


171 


y 


320 




175 


} 


251 


z 


17 2 


z 


321 


J 


112 


J 


252 




1 3 4 


\ 


322 


K 


113 


K 


253 




134 


\ 


323 


L 


114 


L 


254 




134 


\ 


324 


M 


115 


M 


255 


[ 


133 


[ 


325 


N 


116 


N 


256 




134 


\ 


326 


O 


117 


O 


257 




134 


\ 


327 


P 


120 


P 


260 




175 




330 





121 


Q 


261 




13 4 


\ 


331 


R 


122 


P 


262 




134 


\ 


332 




134 


\ 


263 




134 


\ 


333 




134 


\ 


264 




134 


\ 


334 




134 


\ 


265 




134 


\ 


335 




134 


\ 


266 




134 


\ 


336 




134 


\ 


267 




134 


\ 


337 




134 


\ 


270 




134 


\ 


340 




134 


\ 


271 




134 


\ 


341 




134 


\ 


272 




134 


\ 


34 2 


S 


123 


S 


273 




134 


\ 


343 


T 


124 


T 


274 




134 


\ 


344 


U 


125 


U 


275 


] 


135 


] 


345 


V 


126 


V 


276 




134 


\ 


346 


W 


127 


W 


277 




134 


\ 


347 


X 


130 


X 


300 




173 


{ 


350 


Y 


131 


Y 


301 


A 


101 


A 


351 


Z 


132 


Z 


302 


B 


102 


B 


352 




134 


\ 


303 


C 


103 


C 


353 




134 


\ 


304 


D 


104 


D 


354 




134 


\ 


305 


E 


105 


E 


355 




134 


\ 


306 


F 


106 


F 


356 




134 


\ 


307 


G 


107 


G 


357 




134 


\ 


360 





060 


1 


370 


8 


070 


8 


361 


1 


061 


1 


371 


9 


071 


9 


362 


2 


062 


2 


372 




134 


\ 


363 


3 


063 


3 


373 




134 


\ 


364 


4 


064 


4 


374 




134 


\ 


365 


5 


065 


5 


375 




134 


\ 


366 


6 


066 


6 


376 




134 


\ 


367 


7 


067 


7 


377 




134 


\ 
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MONSYM 



B-l 



MONSYM 



; UPD ID= 74, <5 . UTILITIES>MONSYM . MAC . 78 , 22-Jan-82 16:08:17 by MURPHY 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED 
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE. 

COPYRIGHT (C) 1976,1977,1978,1979,1980,1981 BY DIGITAL EQUIPMENT CORPORATION, 
MAYNARD, MASS. 

SEARCH MACSYM ;SOME SYMBOLS ARE DEFINED VIA MACROS 

;MONITOR CALL DEFINITIONS AND ERROR MNEMONICS 

NOTE: 

THE FOLLOWING SYMBOLS ARE RESERVED: 

SYMBOL RESERVED BY 



.OF??? RMS-20 

.SZ??? RMS-20 

.PS??? RMS-20 

; MACRO TO DEFINE JSYS NAMES 

DEFINE DEFJS (NAME ,NUM , SECT , XTRA ,OLDNEW) < 
OPDEF NAME'% [104B8+NUM] 
IFDEF .PSECT,< 
INTERN NAME'%> 
IFIDN <OLDNEW>,<OLD>,< 
OPDEF NAME [104B8+NUM] 
IFDEF .PSECT,< 
INTERN NAME>>> 

SALL 

IFNDEF REL,<REL==0> ASSEMBLING REL IF NON-0 

IFE REL,< 

UNIVERSAL MONSYM> 
IFN REL,< 

TITLE MONSYM 
IFNDEF .PSECT,< 
.DIRECT .XTABM> 
> 
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MONSYM 



;JSYS DEFINITIONS WITH 'NIM' AS A FOURTH ARGUMENT ARE CLASSIFIED 
; AS 'NOT IN MONITOR 1 



DEFINE JSLIST < 



DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 



LOGIN 

CRJOB 

LGOUT 

CACCT 

EFACT 

SMON,6 

TMON , 7 

GETAB 

ERSTR 

GETER 

GJINF 

TIME,1 

RUNTM 

SYSGT 

GNJFN 

GTJFN 

OPENF 

CLOSF 

RLJFN 

GTSTS 

STSTS 

DELF,2 

SFPTR 

JFNS,3 

FFFFP 

RDDIR 

CPRTF 

CLZFF 

RNAMF 

SIZEF 

GACTF 

STDIR 

DIRST 

BKJFN 

RFPTR 

CNDIR 

RFBSZ 

SFBSZ 

SWJFN 

BIN, 50 

BOUT, 5 

SIN, 52 

SOUT,5 

RIN,54 

ROUT, 5 

PMAP,5 

RPACS, 

SPACS, 

RMAP,6 

SACTF, 

GTFDB, 

CHFDB, 

DUMPI, 

DUMPO, 

DELDF, 

ASND,7 

RELD,7 

CSYNO, 



1, MSEC1 
2,MSEC1 
3,MSEC1 
4,MSEC1 
5,MSEC1 
,MSEC1, 
,MSEC1, 
10, MSEC 



11 
12 
13 



4,MSEC1 



15 
16 
17 
20 
21 
22 
23 
24 
25 



6,MSEC1 



27 



31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 
47 



MSEC 
MSEC 
MSEC 



MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 



MSEC 



0,MSEC1 



MSEC 
MSEC 
,NIM 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
,NIM 
MSEC 
MSEC 
MSEC 
,MSEC1, 
1,MSEC1 
,MSEC1, 
3, MS EC 1 
,MSEC1, 
5, MS EC 1 
6,MSEC1 
57, MSEC 
6 0, MSEC 
1,MSEC1 
6 2, MSEC 
6 3, MS EC 
6 4, MSEC 
6 5, MSEC 
6 6, MS EC 
67, MSEC 
0,MSEC1 
1,MSEC1 
72, ,NIM 



, ,OLD 
, ,OLD 
, ,OLD 
, ,OLD 
,NIM,OLD 
,OLD 
,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
. .OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 

,OLD 

,OLD 
. .OLD 
1, ,OLD 

OLD 

,OLD 

,OLD 
OLD 

,OLD 

,OLD 

,OLD 

,OLD 

,OLD 

,OLD 

,OLD 

,OLD 



,OLD 



,OLD 
,OLD 
,OLD 



,OLD 
OLD 

,OLD 
OLD 

,OLD 
OLD 
OLD 
,OLD 
,OLD 
OLD 
,OLD 
,OLD 
,OLD 



LD 
LD 



,0 

,0 
1, ,OLD 

OLD 

OLD 
,OLD 



; OBSOLETE, ,OLD 



;OBSOLETE, ,OLD 
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DEFJS 


PBIN,73,MSEC1, ,OLD 




DEFJS 


PB0UT,74,MSEC1, ,OLD 




DEFJS 


PSIN,75, ,NIM,OLD 




DEFJS 


PS0UT,7 6,MSEC1, ,OLD 




DEFJS 


MTOPR, 7 7,MSEC1, 


p OLD 




DEFJS 


CFIBF,100,MSEC1 


,OLD 




DEFJS 


CFOBF,101 f MSEC1 


,OLD 




DEFJS 


SIBE,102,MSEC1, 


,OLD 




DEFJS 


SOBE,103,MSEC1, 


r OLD 




DEFJS 


DOBE,104,MSEC1, 


,OLD 




DEFJS 


GTABS,105,MSEC1 


,OLD 


;OBSOLETE 


DEFJS 


STABS, 106,MSEC1 


,OLD 


;OBSOLETE 


DEFJS 


RFMOD,107,MSEC1 


,OLD 




DEFJS 


SFMOD,110,MSEC1 


, ,OLD 




DEFJS 


RFPOS,lll,MSECl 


,OLD 




DEFJS 


RFCOC,112,MSECl 


,OLD 




DEFJS 


SFCOC,113,MSECl 


,OLD 




DEFJS 


STI,114,MSEC1, ,C 


)LD 




DEFJS 


DTACH,115,MSEC1 


,OLD 




DEFJS 


ATACH,116,MSEC1 


,OLD 




DEFJS 


DVCHR,117,MSEC1 


,QLD 




DEFJS 


STDEV,120,MSEC1 


,OLD 




DEFJS 


DEVST,121,MSEC1 


,OLD 




DEFJS 


MOUNT, 122, MSEC1 


,OLD 


;OBSOLETE 


DEFJS 


DSMNT,123, , ,OLD 


,-OBSOLETE 


DEFJS 


INIDR,124,MSEC1 , ,QLD 


; OBSOLETE 


DEFJS 


SIR,125,MSEC1, ,OLD 




DEFJS 


EIR,126,MSEC1, ,OLD 




DEFJS 


SKPIR,127,MSEC1, ,OLD 




DEFJS 


DIR,130,MSEC1, ,OLD 




DEFJS 


AIC,131,MSEC1, ,OLD 




DEFJS 


IIC,132,MSEC1, ,OLD 




DEFJS 


DIC,133,MSEC1, ,OLD 




DEFJS 


RCM,134,MSEC1, ,OLD 




DEFJS 


RWM,135,MSEC1, ,OLD 




DEFJS 


DEBRK,136,MSEC1, ,OLD 




DEFJS 


ATI ,137, MSEC1, ,OLD 




DEFJS 


DTI,140,MSEC1, ,OLD 




DEFJS 


CIS,141,MSEC1, ,OLD 




DEFJS 


SIRCM,142,MSEC1, ,OLD 




DEFJS 


RIRCM,143,MSEC1 


,OLD 




DEFJS 


RIR,144,MSEC1, ,( 


)LD 




DEFJS 


GDSTS,145,MSEC1 


,OLD 




DEFJS 


SDSTS,146,MSEC1 


,OLD 




DEFJS 


RESET, 147, MSEC1 


,OLD 




DEFJS 


RPCAP,150,MSEC1 


,OLD 




DEFJS 


EPCAP,151,MSEC1 


,OLD 




DEFJS 


CF0RK,152,MSEC1 


,OLD 




DEFJS 


KF0RK,153,MSEC1 


,OLD 




DEFJS 


FF0RK,154,MSEC1 


,OLD 




DEFJS 


RF0RK,155,MSEC1 


,OLD 




DEFJS 


RFSTS,156,MSEC1 


,OLD 




DEFJS 


SF0RK,157,MSEC1 


,OLD 




DEFJS 


SFACS,160,MSEC1 


,OLD 




DEFJS 


RFACS,161,MSEC1 


,OLD 




DEFJS 


HF0RK,162,MSEC1 


,OLD 




DEFJS 


WF0RK,163,MSEC1 


,OLD 




DEFJS 


GFRKH,164,MSEC1 


,OLD 




DEFJS 


RFRKH,165,MSEC1 


,OLD 




DEFJS 


GFRKS,166,MSEC1 


,OLD 




DEFJS 


DISMS,167,MSEC1 


,OLD 




DEFJS 


HALTF,170,MSEC1 / 


,OLD 




DEFJS 


GTRPW,171,MSEC1 


,OLD 
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DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 

DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 

DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 



GTRPI, 
RTIW,1 
STIW,1 
SOBF,l 
RWSET, 
GETNM, 
GET, 20 
SFRKV, 
SAVE, 2 
SSAVE, 
SEVEC, 
GEVEC, 
GPJFN, 
SPJFN, 
SETNM, 
FFUFP, 
DIBE,2 
FDFRE, 
GDSKC, 
LITES, 
TLINK, 
STPAR, 
ODTIM, 
IDTIM, 
ODCNV, 
IDCNV, 
NOUT,2 
NIN,22 
STAD,2 
GTAD , 2 
ODTNC , 
IDTNC, 
FLIN,2 
FLOUT, 
DFIN,2 
DFOUT, 



172, MSEC 
73,MSEC1 
74,MSEC1 
75,MSEC1 
176, MSEC 
177, MSEC 
0,MSEC1, 
201, MSEC 
02, MSEC1 
203, MSEC 
204, MSEC 
205, MSEC 
206, MSEC 
207, MSEC 
210, MSEC 
2 11, MSEC 
12,MSEC1 
213, ,NIM 
214, MSEC 
215, MSEC 
216, MSEC 
217, MSEC 
220, MSEC 
221, MSEC 
222, MSEC 
223, MSEC 
24,MSEC1 
5,MSEC1, 
26, MSEC1 
27,MSEC1 
230, MSEC 
231, MSEC 
32,MSEC1 
2 3 3, MSEC 
34, MSEC1 
235, MSEC 



CRDIR,2 
GTDIR,2 
DSKOP,2 
SPRIW,2 
DSKAS,2 
SJPRI,2 
STO,246 
ARCF,24 
ASNDP,2 
RELDP,2 
ASNDC,2 
RELDC,2 
STRDP,2 
STPDP,2 
STSDP,2 
RDSDP,2 
WATDP,2 



40,MSEC1 
41,MSEC1 
42,MSEC1 
43,MSEC1 
44,MSEC1 
45,MSEC1 
,MSEC1, , 
7,MSEC1, 
60, ,NIM, 
,NIM, 
,NIM, 
,NIM, 
,NIM, 
,NIM, 
,NIM, 
,NIM, 
,NIM, 



,OLD 

OLD 

OLD 

OLD 

,OLD 

,OLD 



,OLD 
,OLD 
OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
OLD 

,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
OLD 

,OLD 
OLD 
OLD 
,OLD 
,OLD 
OLD 
,OLD 
OLD 
,OLD 



GTNCP,2 72 
GTHST,273 
ATNVT,2 74 
CVSKT,275 
CVHST,276 
FLHST,277 



MSEC1 
MSEC1 
MSEC1 
MSEC1 
MSEC1 
MSEC1 



,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 

OLD 

,OLD 

OLD 

OLD 

OLD 

OLD 

OLD 

OLD 

OLD 

OLD 

OLD 

,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 



;OBSOLETE 



;ARCHIVE SYSTEM JSYS 



TOPS 2 AN 
TOPS 2 AN 
TOPS 2 AN 
TOPS20AN 
TOPS 20 AN 
TOPS20AN 



DEFJS GCVEC,300,MSEC1, ,OLD 
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DEFJS 


SCVEC,301,MSEC1, ,OLD 




DEFJS 


STTYP,3 2,MSEC1, ,OLD 




DEFJS 


GTTYP,303,MSEC1, ,OLD 




DEFJS 


BPT,304,MSEC1, ,OLD 


;OBSOLETE 


DEFJS 


GTDAL, 305,MSEC1, ,OLD 




DEFJS 


WAIT, 306, MSEC1, ,OLD 




DEFJS 


HSYS,307,MSEC1, ,OLD 




DEFJS 


USRIO,310,MSEC1, ,OLD 




DEFJS 


PEEK, 311, MSEC1, ,OLD 




DEFJS 


MSFRK,312,MSEC1, ,OLD 




DEFJS 


ES0UT,313,MSEC1, ,OLD 




DEFJS 


SPLFK,314,MSEC1, ,OLD 




DEFJS 


ADVIS,315, ,NIM,OLD 




DEFJS 


JOBTM,316, ,NIM,OLD 




DEFJS 


DELNF,317,MSEC1, ,OLD 




DEFJS 


SWTCH,3 20,MSEC1, ,OLD 


; OBSOLETE 


DEFJS 


TF0RK,321,MSEC1, ,OLD 




DEFJS 


RTFRK,322,MSEC1, ,OLD 




DEFJS 


UTFRK,3 2 3,MSEC1, ,OLD 




DEFJS 


SCTTY,324,MSEC1, ,OLD 





DEFJS SETER,336,MSEC1, ,OLD 
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;NEW (NOT IN BBN TENEX) JSYS'S ADDED STARTING AT 500 



DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 
DEFJS 



RSCAN, 
HPTIM, 
CRLNM, 
INLNM, 
LNMST, 
RDTXT, 
SETSN, 
GETJI, 
MSEND, 
MRECV, 
MUTIL, 
ENQ,51 
DEQ,51 
ENQC,5 
SNOOP, 
SPOOL, 
ALLOC, 
CHKAC, 
TIMER, 
RDTTY, 
TEXTI, 
UFPGS, 
SFPOS, 
SYERR, 
DIAG, 5 
SINR,5 
SOUTR, 
RFTAD, 
SFTAD, 
TBDEL, 
TBADD, 
TBLUK, 
STCMP, 
SETJB, 
GDVEC, 
SDVEC, 
COMND, 
PRARG, 
GACCT, 
LPINI, 
GFUST, 
SFUST, 
ACCES, 
RCDIR, 
RCUSR, 
MSTR,5 
STPPN, 
PPNST, 
PMCTL, 
PLOCK, 
BOOT, 5 
UTEST, 
USAGE, 
WILD, 5 
VACCT, 
NODE, 5 
ADBRK, 
SINM,5 
SOUTM, 
SWTRP , 
GETOK, 



500, MSEC 
501, MSEC 
502, MSEC 
503, MSEC 
504, MSEC 
505, MSEC 
506, MSEC 
5 07, MSEC 
510, MSEC 
5 11, MSEC 
512, MSEC 
3,MSEC1, 
4,MSEC1, 
15,MSEC1 
516, MSEC 
5 17, MSEC 
520, MSEC 
521, MSEC 
522, MSEC 
523, MSEC 
524, MSEC 
525, MSEC 
526, MSEC 
527, MSEC 
30,MSEC1 
31,MSEC1 
532, MSEC 



533 
534 
535 
536 
537 
540 
541 
542 
543 
544 
545 
546 
547 
550 
551 
552 
553 
554 



556 
557 
560 
561 



563 
564 



566 



570 



572 
573 
574 



MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 
MSEC 



55,MSEC1 



MSEC 
MSEC 
MSEC 
MSEC 



62,MSEC1 



MSEC 
MSEC 



1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
1, ,OLD 
OLD 
OLD 
OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
,OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 
LD 
OLD 
OLD 
OLD 
OLD 
OLD 
OLD 



65,MSEC1 



MSEC1 



67,MSEC1 



MSEC! 



71, MSEC1 



O 



OLD 

OLD 
OLD 
OLD 



;OBSOLETED BY RDTTY AND TEXTI 



MSEC 
MSEC 
MSEC 
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DEFJS 


RCV0K,575,MSEC1 


DEFJS 


GIV0K,576,MSEC1 


DEFJS 


SKED,577,MSEC1 


DEFJS 


MTU,600,MSEC1 


DEFJS 


XRIR,601,MSEC1 


DEFJS 


XSIR,602,MSEC1 


DEFJS 


PDVOP,603,MSEC1 


DEFJS 


NTMAN,604,MSEC1 


DEFJS 


XSFRK,605,MSEC1 


DEFJS 


XGVEC,606,MSEC1 


DEFJS 


XSVEC,607,MSEC1 


DEFJS 


RSMAP,610,MSEC1 


DEFJS 


XRMAP,611,MSEC1 


DEFJS 


XGTPW,612,MSEC1 


DEFJS 


XSSEV,613,MSEC1 


DEFJS 


XGSEV,614,MSEC1 



SCHEDULER CONTROL JSYS 

MTU JSYS 

EXTENDED RIR 

EXTENDED SIR 

MANIPULATE PROGRAM DATA VECTORS 

DECNET NETWORK MANAGEMENT INTERFACE 

START FORK AT GLOBAL PC 

GET FULL ENTRY VECTOR 

SET FULL ENTRY VECTOR 

READ SECTION MAP 

EXTENDED RMAP 

EXTENDED GET TRAP WORD 

EXTENDED SET SPECIAL ENTRY VECTOR 

EXTENDED GET SPECIAL ENTRY VECTOR 



; TEMPORARY JSYS DEFINITIONS 



DEFJS SNDIM,750,MSEC1, ,OLD 
DEFJS RCVIM,751,MSEC1, ,OLD 
DEFJS ASNSQ,752,MSEC1, ,OLD 
DEFJS RELSQ,753,MSEC1, ,OLD 



TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS 20 AN 



DEFJS 


METER, 766, MSEC1 


DEFJS 


SMAP,767,MSEC1 


DEFJS 


THIBR,770,MSEC1, ,OLD 


DEFJS 


TWAKE,771,MSEC1, ,OLD 


DEFJS 


MRPAC,7 7 2,MSEC1 , ,OLD 


DEFJS 


SETPV,773, ,NIM,OLD 


DEFJS 


MTALN,774,MSEC1, ,OLD 


DEFJS 


TTMSG,7 7 5,MSEC1, ,OLD 


DEFJS 


MDDT,777,MSEC1 



; METER JSYS. FOR KL ONLY 
; CREATE AND MAP SECTIONS 



> ; ; ; END OF DEFINE JSLIST 
;NOW EXPAND THE JSYS DEFINITIONS 
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JSLIST 

; ERROR CONDITION INSTRUCTIONS 

; FOLLOWING A JSYS WHICH FAILS 

OPDEF ERJMP [JUMP 16,0] 
OPDEF ERCAL [JUMP 17,0] 

IFNDEF FOR,< 

IFDEF .PSECT,< 
INTERN ERJMP, ERCAL 

>> 



THESE ARE NOP ' S UNLESS IMMEDIATELY 



;JUMP ON ERROR 

;CALL ON ERROR (SIMULATE PUSHJ 17, ADR] 



DEFINE GOPDEF (OP,DEF)< 

OPDEF OP [DEF] 
IFNDEF FOR,< 
IFDEF .PSECT,< 

INTERN OP>>> 

; THE FOLLOWING OPCODES ARE USED TO PERFORM THE EXTENDED 
; ADDRESSING FUNCTIONS. 



GOPDEF XJRSTF,<JRST 5,0> 
GOPDEF XJEN,<JRST 6,0> 
GOPDEF XPCW,<JRST 7,0> 
GOPDEF XSFM,<JRST 14, 0> 
GOPDEF XMOVEI,<SETMI 0,0> 
GOPDEF XHLLI,<HLLI 0,0> 

;OTHER VARIANTS OF JRST 

GOPDEF PORTAL, < JRST 1,0> 
GOPDEF JRSTF,<JRST 2,0> 
GOPDEF JEN,<JRST 12, 0> 

IFIW==:1B0 
EFIW==:0 



RESTORE FLAGS AND PC 

RESTORE FLAGS, PC AND DISMISS 

EXCHANGE FLAGS AND PC 

SAVE PC FLAGS IN MEMORY 

EXTENDED MOVE I 

INSTRUCTION TO PUT IMMEDIATE ADDRESS IN LH 



; INSTRUCTION FORMAT INDIRECT WORD 
; EXTENDED FORMAT INDIRECT WORD 



;THE NO-OPERATION INSTRUCTION (MAY CHANGE FROM PROCESSOR TO PROCESSOR) 

GOPDEF NOP,<TRN 0,0> 
.NODDT NOP 

; SPECIAL LOSEG SYMBOLS 



. JBHSO== 


:75 




. JBEDV== 


:112 






. EDCNT== 







. EDHSB== 


1 




. EDSYM== 


2 




. EDUSY== 


3 




. EDHSF== 


4 



, , HIGHSEG ORIGIN PAGE NUMBER 
POINTER TO EXEC DATA VECTOR 
'EDV',, COUNT (INCLUDES THIS WORD) 
POINTER TO HIDDEN SYMBOL MAP SWITCHING BLOCK 
.JBSYM IN SYMBOL SPACE 
.JBUSY IN SYMBOL SPACE 
POINTER TO SYMBOLS HIDDEN FLAG WORD 
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***************************************** 

JSYS SPECIFIC ARGUMENTS 

THE FOLLOWING ARE ORDERED ALPHABETICALLY BY JSYS NAME 

***************************************** 



;ACCES - 


ACCESS 


AC%CON== 


:1B0 


AC%OWN== 


:1B1 


AC%REM== 


:1B2 



A DIRECTORY (E.G., BY CONNECTING) 



;OFFSETS IN ARGUMENT BLOCK 



.ACDIR== 
.ACPSW== 
.ACJOB== 



CONNECT TO THE SPECIFIED DIRECTORY 
GAIN OWNERSHIP 
REMOVE OWNERSHIP 



DIRECTORY DESIGNATOR 
POINTER TO PASSWORD STRING 
JOB NUMBER (-1 FOR SELF) 



ADBRK - Address break JSYS function codes and bits 
FUNCTION CODES 



ABSET== 
ABRED== 
ABCLR== 
ABGAD== 



SET USER ADDRESS BREAK 

READ USER ADDRESS BREAK 

CLEAR USER ADDRESS BREAK 

GET ADDRESS OF TRAPPED INSTRUCTION 



FUNCTION BITS FOR FUNCTION .ABSET 



AB%RED== 
AB%WRT== 
AB%XCT== 



1B0 
1B1 
1B2 



; ALLOC JSYS FUNCTION CODES 
.ALCAL==:0 



;READ 
; WRITE 
;EXECUTE 



;ALLOCATE A DEVICE 



; ARCF 



.ARRAR==:0 






Requ 


.ARCLR== 







Clea 


. ARSET== 


1 




Set 


; AR%NDL can be 


specified 


in AC2, def 


.ARRIV==:1 






■ Requ 


.AREXM==:2 






• File 


.ARRFR==:3 






Requ 


AR%NMS==:1B0 






Requ 


AR%WAT==:1B1 






Wait 


. ARDIS==:4 






Clea 


AR%CR1==:1B0 






Clea 


AR%CR2==:1B1 






Clea 


.ARSST==: 5 






Set 


•AROFL==:0 






Flag 


AR%01==:1BO 






• Set 


AR%02==: 1B1 






• Set 


AR%0FL==:1B2 






• Flus 


AR%ARC==:1B3 






• Set 


AR%CRQ==:1B4 






Clea 


.ARTP1==:1 






■ Tape 


.ARSF1==:2 






XWD 


AR%TSN==:777777B17 




Tape 



lest file archive (user) 
ir the request 

the request 

ined elsewhere 
lest file migration (system) 

exempt from migration (system) 
lest file's contents be restored to disk 
lest no msg on restoration 

for file to be restored to disk 
ir archive status foe file 
ir 1st run info 
ir 2nd run info 

archive status for file 

[S 

run 1 info 
run 2 info 
;h contents of file 
FB%ARC (archive the file) 
r archive/migration request 

1 ID 
TSN 1, TFN 1 

saveset number 
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AR%TFN==:777777B35 
ARTP2==:3 
ARSF2==:4 

AR%TSN==:777777B17 
AR%TFN==:777777B35 
ARODT==:5 
ARPSZ==:6 



.ARRST== 


6 


.ARGST== 


7 


.ARRFL== 


10 


.ARNAR== 


11 


; Function & 


.RETM==:0 


.RETR==:0 


.RETRW==:1 


.NOTM==:l 


.FLXP==:0 


.ACLR== 


= :1 



Tape file number 

Tape 2 ID 

XWD TSN 2, TFN 2 

Tape saveset number 

Tape file number 

Date and time 

Number of pages in the file (.ARGST only) 

Restore contents to archived file 

Get. tape info for file (blk as for ARSST) 

Retrieve failed 

Set/clear resist archive 



reason codes for IPCF msgs 



Send retrieve message 
Normal retrieve 
User waiting for retrieve 
Send notification message 
Archive file expunged 
Archive status cleared 



;ATNVT 



AN%NTP==:1B2 



; TOPS 20 AN 

; TOPS 20 AN ;NEW TELNET PROTOCOL 



;ATACH 

AT%CCJ== 
AT%NAT== 
AT%TRM== 
AT%JOB== 



1B0 
1B1 
1B2 
777777B3!) 



C JOB WHEN ATTACHED 
NO ATTACH 

ATTACH JOB TO TERMINAL IN REGISTER 
JOB NUMBER 
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; BOOT 








.BTROM==: 




BTDTE==:0 




.BTLDS==- 


1 

BTERR==:1 

BTSEC==:2 




.BTLOD==- 


2 




.BTSMP== 


2 
BTFLG==:3 






BT%BEL==:1B0 ; 




BTCNT==:4 






BTLPT==:5 




.BTDMP== 


3 

BTDPT==:5 




.BTIPR== 


4 
BTPRV==:1 




.BTTPR== 


5 




.BTSTS== 


6 
BTCOD==:l 




•BTBEL== 


7 




.BTRMP== 


10 
BTMPT==:5 




.BTKML== 


11 

BTKMC==:0 
. BTKER==:1 






BT%CVE==:1B0 ; 




BT%DVE==:1B1 




BT%RVE==:1B2 




BTKCC== 


2 






BTKCP== 


3 






BTKDC== 


4 






. BTKDP== 


5 






. BTKRC== 


6 






. BTKRP== 


7 






. BTKSA== 


10 






BT%KSA==:1B0 


.BTKMD== 


:12 




.BTRLC== 


:13 

. BTPRT==:0 






BT%ZRO==:1BO 




. BTZTM== 


1 






. BTSCC== 


2 






. BTSCP== 


:3 






. BTRCC== 


:4 






. BTRCP== 


:5 






. BTTCC== 


6 






. BTTCP== 


7 




.BTCLI== 


:14 
.BTLID==:1 




.BTCPN== 


:15 




.BTD60== 


:16 




I 


ZJEFSTR (BT6DTE,0 


35,36) ' 




. BT6DTE==:0 




I 


DEFSTR (BT6ERR,1 


35,36) 




.BT6ERR==:1 






D6%BSY== 


1B0 




D6%QHD== 


1B1 




D6%HDD== 


1B2 




D6%NDT== 


1B3 




D6%RED== 


1B4 






D6%QDT== 


1B5 



ACTIVATE ROM BOOT 

DTE-20 NUMBER 

LOAD SECONDARY BOOTSTRAP PROGRAM 

ERROR FLAGS 

ADDRESS OF SECONDARY BOOTSTRAP PROGRAM 

LOAD MEMORY (OBSOLETE) 

SEND MOP MESSAGE 

FLAGS 

SEND TO -11 DOORBELL AFTER SETUP 

NUMBER OF BYTES TO BE TRANSFERRED 

BYTE POINTER TO DATA TO BE LOADED 

DUMP MEMORY 

BYTE POINTER TO DESTINATION OF DUMPED DATA 

INITIALIZE COMMUNICATIONS PROTOCOL 

PROTOCOL VERSION NUMBER 

TERMINATE COMMUNICATIONS PROTOCOL 

RETURN PROTOCOL STATUS 

STATUS CODE 

WAIT FOR DOORBELL 

READ MOP MESSAGE 

POINTER TO DESTINATION FOR MOP MESSAGE 

LOAD KMC11 

KMC11 ADDRESS 

ERROR FLAGS 

CRAM VERIFY ERROR (RH IS BAD DATA) 

DRAM VERIFY ERROR (RH IS BAD DATA) 

REG VERIFY ERROR (RH 



IS BAD DATA) 
(16 BIT DATA) 



(8 BIT DATA) 



COUNT OF CRAM DATA 
POINTER TO CRAM DATA 
COUNT OF DRAM DATA 
POINTER TO DRAM DATA 
COUNT OF REGISTER DATA 

POINTER TO REGISTER DATA (16 BIT DATA) 
RH IS STARTING ADDRESS 
IS SET RH WANT TO START KMC11 
DUMP KMC11 

RETURN LINE COUNTERS 
PORT NUMBER 

CLEAR COUNTERS AFTER READING 
TIME SINCE COUNTERS HAVE BEEN ZEROED 
STATUS COUNT COUNT 
STATUS COUNT POINTER 
RECEIVE COUNT COUNT 
RECEIVE COUNT POINTER 
TRANSMIT COUNT COUNT 
TRANSMIT COUNT POINTER 
CONVERT LINEID TO PORT NUMBER 
POINTER TO ASCIZ LINE-ID 
CONVERT PORT NUMBER TO LINE-ID 
DN60 PROTOCOL OPERATION 
;DTE number 

;returned error flags 

protocol flags 

port is busy - sign bitness is 

in testing 
header has been queued 

tl 
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used 




MONSYM 



D6%DTD== 


1B6 


D6%RBL== 


1B7 


D6%RDN== 


1B8 


D6%DBL== 


1B9 


D6%DDN== 


1B10 


D6%FDN== 


1B11 


D6%BDP== 


1B30 


D6%ARD== 


1B31 



DEFSTR 

.BT6HBO 

DEFSTR 

.BT6HDR= 

DEFSTR 

.BT6DBC= 



DEFSTR 
.BT6PTR= 



DEFSTR 

.BT6TMR= 

DEFSTR 

.BT6TAS= 

DEFSTR 

.BT6THQ= 

DEFSTR 

.BT6TRD= 

DEFSTR 

.BT6TDD= 

DEFSTR 

.BT6TFR= 

BTSTA==:16 

BTSSP==:17 

.BTPRI= 

BTSTP==:20 

BTSDD==:21 

.BTMSG= 
.BTLEN= 

BTRDD==:22 

.BTSUP= 
. BTSDW= 
.BTCMP= 
.BTSSF= 

,BTCHN==:23 

.BTESI= 



D6%TRS==:1B32 
D6%TDT==:1B33 

D6%TP0==:1B34 
D6%NT6==:1B35 

(BT6HBC,2,17,18) 

= :2 

(BT6HDR,2, 35,18) 

= :2 

(BT6DBC,3, 35,36) 

= :3 



(BT6PTR,4,35,36) 
= :4 



(BT6TMR,5,35,36) 
= :5 

(BT6TAS,6,35,36) 
= :6 

(BT6THQ,7, 35,36) 
= :7 

(BT6TRD,10,35,36) 
= :10 

(BT6TDD,11,35,36) 
= :11 

(BT6TFR,12,35,36) 
= :12 



to -11 done for write data seen 

to -10 doorbell for response header se 

to -10 done for response header seen 

to -10 doorbell for read data seen 

to -10 done for read data seen 

to -10 done for read data was faked 

error flags 

bad data byte ptr 

11 attempted to send read data when 

when none was expected 
timed out waiting for response header 
timed out waiting for read data 

;timed out waiting for port to be free 
;not a DN60 front end 

;DN60 header byte count 

;DN60 header address (begins on word) 

;data byte count 

positive => write data mode 
zero => no data transfer 
negative => read data mode 
data byte ptr 

;the following are returned for timing 
; analysis 
;time of request 

;TIME DTE ASSIGNED 

;time header queued to 11 

;time of -10 done for response header 

;time of -10 done for data 

;time finished request 



= :1 



= :1 



= :3 
= :4 
BT%CTL==:1B0 

= :1 



SET STATION POLLING STATUS 

SET LINE STARTUP PRIORITY 

PRIORITY VALUE 

SET STATION POLLING PRIORITY 

SEND DDCMP MESSAGE 

ADDR OF MESSAGE 

BYTE COUNT OF MESSAGE 

RECEIVE A MESSAGE FROM DDCMP 

STATION CAME UP 

STATION WENT DOWN 

XMIT COMPLETE 

STARTUP FAILED 

CONTROL MESSAGE 

ASSIGN A SOFTWARE INTERRUPT CHANNEL 

CHANNEL NUMBER 



;CFORK 

CR%MAP==:1B0 

CR%CAP==:1B1 



SET MAP FOR NEW FORK TO POINT TO 

THIS PROCESS 
MAKE CAPABILITIES IDENTICAL 
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MONSYM 



CR%ACS==:1B3 

CR%ST==:1B4 

CR%PCV==:777777B35 



SET ACS FROM BLOCK 
START PROCESS AT PC 
VALUE OF PC 



;CHFDB 



CF%NUD== 
CF%DSP== 
CF%JFN== 



1B0 

777B17 

777777B35 



NO UPDATE DIRECTORY 
FDB DISPLACEMENT 
JFN 



B-14 



MONSYM 



;CHKAC JSYS DEFINITIONS 

;CHKAC FLAG DEFINITIONS 

CK%JFN==:1B0 ;JFN IS GIVEN AS AN ARGUMENT 

;CHKAC ARGUMENT BLOCK OFFSET VALUES 



CKAAC== 
CKALD== 
CKACD== 
CKAEC== 
CKAUD== 
CKAPR== 



;CHKAC ACCESS CODES 



CKARD== 





CKAWT== 


1 


CKAWR== 


1 


CKAEX== 


2 


CKAAP== 


3 


CKADL== 


4 


CKADR== 


6 


CKAOF== 


7 


CKACN== 


10 


CKACF== 


11 



ACCESS CODE 

LOGGED IN USER NUMBER OF USER 

CONNECTED DIR NUMBER OF USER 

ENABLED CAPABILITIES OF USER BEING CHK'D 

DIR NUMBER OF DIRECTORY CONTAINING FILE 

PROTECTION OF FILE 



READ AN EXISTING FILE 
WRITE AN EXISTING FILE 

(ANOTHER NAME FOR ABOVE) 
EXECUTE AN EXISTING FILE 
APPEND TO AN EXISTING FILE 
GET DIR LISTING OF AN EXISTING FILE 
READ THE DIRECTORY 

OPEN FILES IN DIR (NOT IMPLEMENTED) 
CONNECT TO A DIR 
CREATE FILES IN DIR 



;CLOSF 

CO%NRJ= 
CO%WCL= 
CO%JFN= 



1B0 

1B1 
777777B35 



;TOPS20AN 



NO RELEASE JFN 

WAIT UNTIL MATCHING CLS IS RECEIVED 

JFN 



;CLZFF 



CZ%NIF== 


1B0 


CZ%NSF== 


1B1 


CZ%NRJ== 


1B2 


CZ%NCL== 


1B3 


CZ%UNR== 


1B4 


CZ%ARJ== 


:1B5 


CZ%ABT== 


:1B6 


CZ%NUD== 


:1B7 


CZ%PRH== 


■777777B35 



NO INFERIOR FORK FILES 

NO SELF FORK FILES 

NO RELEASE JFN 

NO CLOSE FILE 

UNRESTRICT 

ALWAYS RELEASE JFN 

ABORT 

NO UPDATE DIRECTORY 

PROCESS HANDLE 
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;CNDIR 

CN%CKP== 
CN%NOC== 
CN%JOB== 
CN%DIR== 



1B0 
1B1 
1B2 
777777B35 



CHECK PASSWORD ONLY 

NO CONNECT 

DOING CONNECT FOR ANOTHER JOB 

DIRECTORY NUMBER 



;COMND 



COMND - COMMAND STATE BLOCK 



. CMFLG== 





.CMIOJ== 


1 


. CMRTY== 


2 


.CMBFP== 


3 


.CMPTR== 


4 


.CMCNT== 


5 


. CMINC== 


6 


.CMABP== 


7 


.CMABC== 


10 


.CMGJB== 


11 


CM%GJB== 


--'.Him 


; COMND - 


FUNCTION 


.CMFNP== 





CM%FNC= 


==:777B8 


CM%FFL= 


==:777B17 


CM%LST= 


--=-.111111 


.CMDAT== 


1 


.CMHLP== 


2 


.CMDEF== 


3 


.CMBRK== 


4 



USER FLAGS, ,REPARSE DISPATCH ADDRESS 

INJFN, ,OUTJFN 

~R BUFFER POINTER 

PTR TO TOP OF BUFFER 

PTR TO NEXT INPUT TO BE PARSED 

COUNT OF SPACE LEFT IN BUFFER AFTER PTR 

COUNT OF CHARACTERS FOLLOWING PTR 

ATOM BUFFER POINTER 

ATOM BUFFER SIZE 

ADR OF GTJFN ARG BLOCK 

ADR OF GTJFN ARG BLOCK 



DESCRIPTOR BLOCK 



FUNCTION AND POINTER 
FUNCTION CODE 
FUNCTION-SPECIFIC FLAGS 
LIST POINTER TO OTHER BLOCKS 
DATA FOR FUNCTION 
HELP TEXT POINTER 
DEFAULT STRING POINTER 
FIELD BREAK MASK POINTER 
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;COMND - FLAGS IN .CMFLG 



MONSYM 



CM%ESC== 


1B0 


CM%NOP== 


1B1 


CM%EOC== 


1B2 


CM%RPT== 


1B3 


CM%SWT== 


1B4 


CM%PFE== 


1B5 


CM%RAI== 


1B6 


CM%XIF== 


1B7 


CM%WKF== 


1B8 



ESC SEEN 

NO PARSE 

END OF COMMAND SEEN 

REPEAT PARSE NEEDED 

SWITCH TERMINATED WITH " : " 

PREVIOUS FIELD ENDED WITH ESC 

RAISE INPUT 

EXCLUDE INDIRECT FILES 

WAKEUP AFTER EACH FIELD 



; FUNCTION BLOCK FLAGS (IN WORD .CMFNP) 



CM%NSF==:1B12 
CM%BRK==:1B13 
CM%P0==:1B14 



CM%HPP== 
CM%DPP== 
CM%SDH== 



1B15 
1B16 
1B17 



SUFFIX MAY BE OMITTED IF DESIRED 

BREAK MASK PRESENT 

PARSE-ONLY 

HELP POINTER PRESENT 

DEFAULT POINTER PRESENT 

SUPPRESS DEFAULT HELP MESSAGE 



; FLAGS FOR CMDIR FUNCTION 

CM%DWC==:1B0 

; FLAGS FOR CMTAD FUNCTION 



CM%IDA== 
CM%ITM== 
CM%NCI== 



1B0 
1B1 
1B2 



;DIRECTORY WILD CARDING ALLOWED 



INPUT DATE 
INPUT TIME 
NO CONVERT TO INTERNAL 



; FLAGS IN KEYWORD TABLE (FIRST WORD OF STRING IF BO-6 = 0) 



CM%INV== 
CM%NOR== 
CM%ABR== 



1B35 
1B34 
1B33 



CM%FW==:1B7 



INVISIBLE 

NO-RECOGNIZE (PLACEHOLDER) 
ABBREVIATION FOR ANOTHER ENTRY 
FLAG WORD (MUST ALWAYS BE ON) 
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;COMND - FUNCTION CODES 



MONSYM 



.CMKEY== 





.CMNUM== 


1 


.CMNOI== 


2 


.CMSWI== 


3 


.CMIFI== 


4 


.CMOFI== 


5 


.CMFIL== 


6 


.CMFLD== 


7 


.CMCFM== 


10 


•CMDIR== 


11 


,CMUSR== 


12 


,CMCMA== 


13 


.CMINI== 


14 


,CMFLT== 


15 


.CMDEV== 


16 


.CMTXT== 


17 


.CMTAD== 


20 


.CMQST== 


21 


.CMUQS== 


22 


.CMTOK== 


23 


.CMNUX== 


24 


.CMACT== 


25 


.CMNOD== 


26 



KEYWORD 

NUMBER 

NOISE WORD 

SWITCH 

INPUT FILE 

OUTPUT FILE 

GENERAL FILESPEC 

ARBITRARY FIELD 

CONFIRM 

DIRECTORY NAME 

USER NAME 

COMMA 

INIT LINE 

FLOATING POINT NUMBER 

DEVICE NAME 

TEXT TO ACTION CHAR 

TIME AND DATE 

QUOTED STRING 

UNQUOTED STRING 

TOKEN 

NUMBER DELIMITED BY NON-DIGIT 

ACCOUNT 

NODE NAME 



,-DEFINE BREAK MASKS 





BRINI. 






BRKCH. 


(0,37) 




BRKCH. 


(40,54) 




BRKCH. 


(56,57) 




BRKCH. 


(72,77) 




BRKCH. 


(100) 




BRKCH. 


(133,140) 




BRKCH. 


(173,177) 


FLDBO. 


= =W0. 




FLDB1. 


= =W1. 




FLDB2. 


= =W2. 




FLDB3. 


= =W3. 





INITIALIZE BREAK MASK FOR STANDARD FIELD 

ALL CONTROL CHARACTERS 

SPACE THROUGH COMMA 

DOT AND SLASH 

COLON THROUGH QUESTION MARK 

ATSIGN 

OPEN BRACKET THROUGH ACCENT GRAVE 

CLOSE BRACKET THROUGH TILDE 

; STANDARD FIELD BREAK MASK 



; KEYWORD BREAK SET. SAME AS STANDARD FIELD FOR NOW 

KEYB0.==FLDB0. 
KEYB1.==FLDB1. 
KEYB2.==FLDB2. 
KEYB3.==FLDB3. 
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;USERNAME BREAK SET 
UNBRK. " . " 





UNBRK. 


"%" 




UNBRK. 


ii * ii 




UNBRK. 


11 $" 




UNBRK. 


H ii 


USRBO. 


= =W0. 




USRB1. 


= =W1. 




USRB2. 


= =W2. 




USRB3. 


= =W3. 





BREAKS ON EVERYTHING EXCEPT DOT AND ALPHABETICS. 



MODIFY FIELD BREAK SET INTO USER BREAK SET. 

DON'T BREAK ON DOT 
DON'T BREAK ON PERCENT 
STAR 

ALLOW DOLLARSIGN! (I NEVER KNEW THAT BEFORE) 
ALLOW UNDERSCORE IN ATOM 



; ACCOUNT MASK CURRENTLY THE SAME AS USER MASK 

ACTB0.==USRB0. 
ACTB1.==USRB1. 
ACTB2.==USRB2. 
ACTB3.==USRB3. 

;FILESPEC FIELD - FILESPEC PUNCTUATION CHARACTERS 
;ARE LEGAL ( : , < , >, . , ; ) 



FILBO. 
FILB1. 
FILB2. 
FILB3. 



UNBRK. 

UNBRK. 
UNBRK. 
UNBRK. 
UNBRK. 
UNBRK. 

=W0. 
=W1. 
=W2. 
=W3. 



;MODIFY USERNAME BREAK SET INTO FILE BREAK SET, 
DON'T BREAK ON THESE 
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;READ DEVICE NAME 



BRINI. 


FLDBO 


UNBRK. 


"$" 


UNBRK. 


ii ii 


DEVBO. 


= =W0. 


DEVB1. 


= =W1. 


DEVB2. 


= =W2. 


DEVB3. 


= =W3. 



,FLDB1. ,FLDB2. ,FLDB3. ;VERY SIMILAR TO STANDARD FIELD 

;ALLOW DOLLARSIGN IN DEVICE NAME (LIKE FILESPI 
; UNDERSCORE TOO 



;READ TO END OF LINE 





BRINI. 






BRKCH. 


.CHLFD 




BRKCH. 


.CHCRT 




BRKCH. 


.CHFFD 


EOLBO. 


= =W0. 




EOLB1. 


= =W1. 




EOLB2. 


= =W2. 




EOLB3. 


= =W3. 





I^ TIALIZE END OF LINE BREAK SET 

BREAK ON LINEFEED 

AND CARRIAGE RETURN 

FORMFEED IS VALID END-OF-LINE 
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MONSYM 



CD%LEN== 


1B0 




CD%PSW== 


1B1 




CD%LIQ== 


1B2 




CD%PRV== 


1B3 




CD%MOD== 


1B4 




CD%LOQ== 


1B5 




CD%NUM== 


1B6 




CD%FPT== 


1B7 




CD%DPT== 


1B8 




CD%RET== 


1B9 




CD%LLD== 


1B10 




CD%UGP== 


1B11 




CD%DGP== 


1B12 




CD%SDQ== 


1B13 




CD%CUG== 


1B14 




CD%DAC== 


1B15 




CD%DEL== 


1B17 




CD%APB== 


777777B35 


.CDLEN== 







( 


:d%nsq== 


1B0 


( 


:d%nce== 


1B1 


( 


:d%ned== 


1B2 


( 


:d%fed== 


1EB3 


•CDPSW== 


i 




.CDLIQ== 


2 




.CDPRV== 


3 




.CDMOD== 


4 




( 


:d%dir== 


1B0 


C 


:d%ana== 


1B1 


C 


:d%rlm== 


1B2 


( 


:d%dar== 


1B7 


.CDLOQ== 


5 




.CDNUM-= 


6 




.CDFPT== 


■7 




.CDDPT== 


10 




.CDRET== 


.11 




•CDLLD== 


:12 




.CDUGP== 


:13 




.CDDGP== 


:14 




.CDSDQ== 


:15 




.CDCUG== 


16 




.CDDAC== 


17 




.CDDNE== 


:20 




.CDDFE== 


21 





FLAGS , , LENGTH OF CRDIR BLOCK 

SET PASSWORD STRING 

SET LOGGED IN QUOTA 

SET PRIVILEGES 

SET MODE BITS 

SET LOGGED OUT QUOTA 

SET DIRECTORY NUMBER FROM PARAM BLK 

SET DEFAULT FILE PROTECTION 

SET DIRECTORY PROTECTION 

SET DEFAULT RETENTION COUNT 

SET LAST LOGIN DATE 

SET USER GROUPS 

SET DIRECTORY GROUPS 

SET SUBDIRECTORY QUOTA 

SET CREATABLE USER GROUPS 

SET DEFAULT ACCOUNT 

DELETE DIRECTORY 

ADDRESS OF PARAMETER BLOCK 

LENGTH OF ARGUMENT BLOCK 

DO NOT UPDATE QUOTAS OF SUPERIOR DIR 

DO NOT CHANGE PARAMETERS OF EXISTING DIRS 

Set def online exp from .CDDNE 

Set def offline exp from .CDDFE 
POINTER TO PASSWORD STRING 
LOGGED IN QUOTA 
PRIVILEGE WORD 
MODE WORD 

DIRECTORY NAME FOR CNDIR ONLY (FILES ONLY; 
ALPHANUMERIC ACCOUNTS 
REPEAT. LOGIN MESSAGES 

Archived online expired files 
LOGGED OUT QUOTA 
DIRECTORY NUMBER 
DEFAULT FILE PROTECTION 
DIRECTORY PROTECTION 
DEFAULT RETENTION COUNT 
LAST LOGIN DATE 
USER GROUPS 
DIRECTORY GROUPS 

MAXIMUM NUMBER OF SUBDIRECTORIES 
POINTER TO CREATABLE USER GROUP LIST 
POINTER TO DEFAULT ACCOUNT 

Default online expiration 

Default offline expiration 
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;CRJOB 
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CJ%LOG== 


1B0 


CJ%NAM== 


1B1 


CJ%ACT== 


3B3 




CJUCA==:0 




CJUAA==:1 




CJUDA==:2 


CJ%ETF== 


1B4 


CJ%FIL== 


1B5 


CJ%ACS== 


1B6 


CJ%OWN== 


1B7 


CJ%WTA== 


1B8 


CJ%NPW== 


1B9 


CJ%NUD== 


1B10 


CJ%SPJ== 


1B11 


CJ%CAP== 


1B12 


CJ%CAM== 


1B13 


CJ%SLO== 


1B14 


CJ%DSN== 


1B17 


.CJNAM== 





.CJPSW== 


1 


.CJACT== 


2 


.CJFIL== 


3 


.CJSFV== 


4 


.CJTTY== 


5 


.CJTIM== 


6 


.CJACS== 


:7 


.CJEXF== 


•10 


.CJPRI== 


•11 


.CJCPU== 


:12 


.CJCAM== 


:13 


.CJSLO== 


:14 


CR%PRA== 


:2545 



ATTEMPT TO LOG IN THE NEW JOB 

USE NAME AND PSWD IN ARG BLK 

WHERE TO GET ACCOUNT 

USE CURRENT ACCT OF CREATOR 

USE ACCOUNT IN ARG BLOCK 

USE DEFAULT ACCOUNT OF NEW USER 

PUT EXEC IN TOP FORK 

GET FILE IN ARG BLOCK 

LOAD THE ACS FROM ARG BLOCK 

RETAIN OWNERSHIP OF NEW JOB 

NEW JOB WAITS TIL ATTACHED 

NO PASSWORD CHECK AT LOGIN TIME 

NO UPDATE OF LAST-LOGIN DATE 

DO SPJFN IN NEW JOB FROM ARG BLK 

PASS ENABLED CAPABILITIES AS ALLOWED 

CAPABILITY MASK AT LOGIN 

SIGNAL (IPCF) AT LOGOUT TIME 

DISOWN EXISTING JOB # IN 3 

NAME STRING POINTER 

PASSWORD STRING POINTER 

ACCOUNT DESIGNATOR/STRING 

FILE NAME STRING POINTER 

SFRKV OFFSET 

TTY DESIGNATOR, OR NULL DESIGNATOR 

TIME LIMIT 

ADDRESS OF 16. WORDS OF AC'S 

EXEC FLAGS, FOR EXEC AC1 

PRIMARY JFN'S FOR SPJFN IN NEW JOB 

CPU LIMIT (0 IF NONE) 

CAPABILITY MASK TO APPLY TO LOGIN 

PID TO SIGNAL AT LOGOUT TIME 

; MAGIC # FOR EXEC/CRJOB LINKAGE VIA PRARG 



;CRLNM 



.CLNJ1== 





.CLNS1== 


1 


.CLNJA== 


2 


.CLNSA== 


3 


.CLNJB== 


4 


.CLNSY== 


5 



DELETE 1 LOGICAL NAME FROM JOB 
DELETE 1 LOGICAL NAME FROM SYSTEM 
DELETE ALL JOB WIDE LOGICAL NAMES 
DELETE ALL SYSTEM LOGICAL NAMES 
CREATE A JOB WIDE LOGICAL NAME 
CREATE A SYSTEM WIDE LOGICAL NAME 
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;DELDF 



DD%DTF== 


1B0 


DD%DNF== 


1B1 


DD%RST== 


1B2 


DD%CHK== 


1B3 



DELETE TEMPORARY FILES 

DELETE NONEXISTENT FILES 

REBUILD THE SYMBOL TABLE 

CHECK THE DIR FOR CONSISTENCY ONLY 



;DELF 



DF%NRJ== 


1B0 


DF%EXP== 


1B1 


DF%FGT== 


1B2 


DF%DIR== 


1B3 


DF%ARC== 


1B4 


DF%CNO== 


1B5 



DF%JFN==777777B35 



DON'T RELEASE JFN 

EXPUNGE CONTENTS 

FORGET (EXPUNGE W/O DEASSIGNING ADDRESSES; 

DELETE, FORGET, AND EXPUNGE A DIRECTORY 
FILE. (ONLY IF ~E-CREATE KILL FAILED) 
Delete of archive status file allowed 
Delete only contents of file 
Immediate expunge implied 

; JFN 



;DIAG JSYS DEFINITIONS 



DG%ADT==:7B2 

DG%DVC==:177B9 

.DGRH0==:130 
.DGRH7==:137 

DG%UNI==:77B29 

DG%SUN==:77B35 



ADDRESS TYPE FIELD 

DEVICE CODE FIELD 

MBCO 

MBC7 

UNIT NUMBER 

SUBUNIT NUMBER 



;DIAG JSYS FUNCTION CODES 



.DGACU== 
.DGACH== 
.DGRCH== 
.DGSCP== 
•DGRCP== 
.DGGCS== 



ASSIGN DEVICE 

ASSIGN CONTROLLER AND ALL DEVICES 

RELEASE DEVICE (S) 

SETUP CHANNEL PROGRAM 

RELEASE CHANNEL PROGRAM 

GET CHANNEL STATUS 



;DIAG NEW CONTROL FUNCTIONS 

.DGGEM==:100 

.DGREM==:101 
.DGPDL==:102 



LEAVE LARGE HOLE FOR MORE RH20 FUNCTIONS 
GET MEM (FOR TGHA ) 
RELEASE MEM (FOR TGHA) 
UNIT ONLINE 
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;DSKAS 



DA%DEA== 


1E0 


DA%ASF== 


1B1 


DA%CNV== 


1B2 


DA%HWA== 


1B3 


DA%INI== 


1B4 


DA%WRT== 


1B5 


DA%ADR== 


777777B35 



DEASSIGN DISK ADDRESS 

ASSIGN FREE PAGE 

CONVERT SOFTWARE TO HARDWARE ADDRESS 

HARDWARE ADDRESS GIVEN 

INITIALIZE THE BIT TABLE 

WRITE THE BIT TABLE FILE 

DISK ADDRESS 
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;DVCHR, DEVUNT AND DVCHl BIT DEFINITIONS 



DV%OUT== 


:1B0 


DV%IN==: 


1B1 


DV%DIR== 


:1B2 


DV%AS==: 


1B3 


DV%MDD== 


:1B4 


DV%AV==: 


1B5 


DV%ASN== 


:1B6 


DV%MDV== 


:1B7 


DV%MNT== 


:1B8 


DV%TYP== 


:777B17 


DV%PSD== 


:1B18 


DV%UNT== 


:77777 


DV%MOD== 


:177777B35 


DV%M0==: 


1B35 


DV%M1==: 


1B34 


DV%M2==: 


1B33 


DV%M3==: 


1B32 


DV%M4==: 


1B31 


DV%M5==: 


1B30 


DV%M6==: 


1B29 


DV%M7==: 


1B28 


DV%M10== 


:1B27 


DV%M11== 


:1B26 


DV%M12== 


:1B25 


DV%M13== 


:1B24 


DV%M14== 


:1B23 


DV%M15== 


:1B22 


DV%M16== 


:1B21 


DV%M17== 


:1B20 


D1%SPL== 


:1B0 


Dl%ALC== 


:1B1 


D1%VVL== 


:1B2 


Dl%NIU== 


:1B3 


D1%INI== 


:1B4 



DEVICE CAN DO OUTPUT 

DEVICE CAN DO INPUT 

DEVICE HAS A DIRECTORY 

DEVICE IS ASSIGNABLE 

DEVICE IS A MULTIPLE DIRECTORY DEVICE 

DEVICE IS AVAILABLE TO THIS JOB 

DEVICE IS ASSIGNED BY ASND 

RESERVED (HISTORICAL) 

DEVICE IS MOUNTED 

DEVICE TYPE FIELD 

PSEUDO DEVICE 

UNIT MASK 

DEVICE DATA MODE 

DEVICE CAN BE OPENED IN MODE 

DEVICE CAN BE OPENED IN MODE 1 

DEVICE CAN BE OPENED IN MODE 2 

DEVICE CAN BE OPENED IN MODE 3 

DEVICE CAN BE OPENED IN MODE 4 

DEVICE CAN BE OPENED IN MODE 5 

DEVICE CAN BE OPENED IN MODE 6 

DEVICE CAN BE OPENED IN MODE 7 

DEVICE CAN BE OPENED IN MODE 10 

DEVICE CAN BE OPENED IN MODE 11 

DEVICE CAN BE OPENED IN MODE 12 

DEVICE CAN BE OPENED IN MODE 13 

DEVICE CAN BE OPENED IN MODE 14 

DEVICE CAN BE OPENED IN MODE 15 

DEVICE CAN BE OPENED IN MODE 16 

DEVICE CAN BE OPENED IN MODE 17 

DEVICE IS SPOOLED 

DEVICE IS UNDER CONTROL OF ALLOCATOR 

VOLUME VALID 

DEVICE SLOT IS NOT IN USE (FOR STRUCTURES 

NOT YET MOUNTED) 
DEVICE IS BEING INITIALIZED (STRUCTURE 

IS AVAILABLE ONLY TO THE FORK WHOSE NUMBER 

IS STORED IN SDBSTS) 
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DVDSK== 


:0 


DVMTA== 


:2 


DVDTA== 


:3 


DVPTR== 


:4 


DVPTP== 


5 


DVDSP== 


6 


DVLPT== 


7 


DVCDR== 


10 


DVFE==: ] 


LI 


DVTTY== 


12 


DVPTY== 


13 


DVNUL== 


15 


DVNET== 


16 


DVPLT== 


17 


DVCDP== 


21 


DVDCN== 


22 


DVSRV== 


23 


DVATS== 


24 


DVADS==- 


25 



DISK 

MAGTAPE 

DECTAPE 

PAPER TAPE READER 

PAPER TAPE PUNCH 

DISPLAY 

LINE PRINTER 

CARD READER 

FRONT END DEVICE 

TERMINAL 

PTY 

NULL DEVICE 

ARPA NETWORK 

PLOTTER 

CARD PUNCH 

DECNET ACTIVE COMPONENT 

DECENT PASSIVE COMPONENT 

APPLICATIONS TERMINAL SERVICE 

AYDIN DISPLAY 



;DSKOP 

DOP%SA== 

DOP%AT== 

•DOPPU= 

DOP%CN 

DOP%UN 

DOP%UA 

•DOPSR= 

DOP%SN 

DOP%RA 

DOP%C2 

DOP%K2 

DOP%U2 

DOP%NF== 

DOP%EO== 

DOP%IL== 

DOP%IR== 

DOP%WR== 

DOP%CT== 



1B0 
3B1 
= :1 

37B6 
77B12 
37777777 
= :2 

==:777B10 
==:177777777 
==:7777B11 
==:7777B23 
==:7777B35 
1B9 
1B10 
1B11 
1B12 
1B14 
777777B35 



SOFTWARE ADDRESS 

ADDRESS TYPE FIELD 

PHYSICAL CHANNEL AND UNIT 

CHANNEL NUMBER (OLD FORMAT) 

UNIT NUMBER (OLD FORMAT) 

UNIT ADDRESS 

STRUCTURE AND RELATIVE ADDRESS 

STRUCTURE NUMBER 

RELATIVE ADDRESS 

CHANNEL NUMBER (NEW FORMAT) 

CONTROLLER NUMBER (NEW FORMAT) 

UNIT NUMBER (NEW FORMAT) 

USE NEW FORMAT FOR CHANNEL, UNIT NUMBERS 

ERROR IF UNIT OFFLINE 

INHIBIT ERROR LOGGING 

INHIBIT ERROR RECOVERY 

WRITE 

WORD COUNT 



;DUMPI/DUMPO 



DM%NWT==:1B0 
DM%FIN==:1B1 

DM%PTR==:777777B35 



NO WAIT FOR COMPLETION 
FINISH PREVIOUS REQUEST 
***NOT INPLEMENTED YET*** 
POINTER TO COMMAND LIST 
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;DEFINE DECNET DISCONNECT CODES. THESE ARE STIPULATED BY THE NSP SPEC 
;AND MAY HAVE MEANINGS NOT IMPLIED BY THE COMMENTS 



DCX0==: 





DCX1==: 


1 


DCX2==: 


2 


DCX3==: 


3 


DCX4==: 


4 


DCX5==: 


5 


DCX6==: 


6 


DCX7==: 


7 


DCX8==: 


~D8 


DCX9==: 


~D9 


DCX11== 


:*D11 


DCX21== 


:~D21 


DCX22== 


:~D22 


DCX23== 


:~D23 


DCX24== 


:~D24 


DCX32== 


:~D32 


DCX33== 


:~D33 


DCX34== 


:~D34 


DCX35== 


:~D35 


DCX36== 


:~D36 


DCX37== 


:~D37 


DCX38== 


:~D38 


DCX39== 


:~D39 


DCX40== 


:~D40 


DCX41== 


:~D41 


DCX42== 


:~D42 


DCX43== 


:~D43 



NO SPECIAL ERROR 

RESOURCE ALLOCATION FAILURE 

DESTINATION NODE DOES NOT EXIST 

NODE SHUTTING DOWN 

DESTINATION PROCESS DOES NOT EXIST 

INVALID NAME FIELD 

DESTINATION PROCESS QUEUE OVERFLOW 

UNSPECIFIED ERROR 

THIRD PARTY ABORTED LINK 

USER ABORT (ASYNCHRONOUS DISCONNECT) 

UNDEFINED ERROR CODE 

CI WITH ILLEGAL DESTINATION ADDRESS 

CC WITH ILLEGAL DESTINATION ADDRESS 

CI OR CC WITH ZERO SOURCE ADDRESS 

FLOW CONTROL VIOLATION 

TOO MANY CONNECTIONS TO NODE 

TOO MANY CONNECTIONS TO DEST. PROCESS 

ACCESS NOT PERMITTED 

LOGICAL LINK SERVICES MISMATCH 

INVALID ACCOUNT 

SEGSIZE TOO SMALL 

PROCESS ABORTED 

NO PATH TO DESTINATION NODE 

LINK ABORTED DUE TO DATA LOSS 

DESTINATION PROCESS DOES NOT EXIST 

CONFIRMATION IF DI 

IMAGE DATA FIELD TOO LONG 



;EFACT - FACT FILE ENTRY DEFINITIONS 



.EFHDR==:0 

EF%COD== 
EF%JOB== 
EF%LIN== 
EF%SIZ== 

.EFUSR==:1 

.EFTAD==:2 



777B8 
777B17 
7777B29 
77B35 



HEADER WORD 

ENTRY TYPE CODE 

JOB NUMBER 

LINE NUMBER 

ENTRY SIZE 

USER NUMBER WORD 

TIME AND DATE OF ENTRY 



FACT FILE ENTRY TYPE CODES 



EFLGI== 
EFLGO== 
EFCAC== 
EFATT== 
EFDET== 
EFCHK== 
EFSDU== 
EFDSK== 
EFTIM=: 
EFRES== 
EFLPT== 
EFCDR== 



501 
141 
502 
142 
143 
201 
540 
601 
741 
740 
401 
402 



LOGIN 

LOGOUT 

CHANGE ACCOUNT 

CONSOLE ATTACH 

CONSOLE DETACH 

CHECKPOINT 

START DISK-UTILIZATION ENTRIES 

DISK SPACE UTILIZATION 

TIME SET 

SYSTEM RESTARTED 

LINE PRINTER USAGE 

CARD READER USAGE 
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;ENQ/DEQ BIT DEFINITIONS AND FUNCTION CODES 
; FUNCTION CODES 



ENQBL== 
, ENQAA== 
,ENQSI== 
ENQMA== 
DEQDR== 
DEQDA== 
DEQID== 
ENQCS== 
ENQCG== 
ENQCC== 
ENQCD== 



ENQ BLOCK OPTION 

ENQ ALLOCATE ONLY IF AVAILABLE 

ENQ SOFTWARE INTERRUPT WHEN LOCKED 

ENQ MODIFY ACCESS 

DEQ RESOURCE 

DEQ ALL RESOURCES OF THIS FORK 

DEQ THIS ID NUMBER 

ENQC STATUS 

ENQC GET ENQ/DEQ QUOTA FOR A JOB 

ENQC CHANGE ENQ/DEQ QUOTA FOR A JOB 

ENQC DUMP LOCKS AND QUEUE ENTRIES 



;BIT DEFINITIONS 



EN%SHR== 


1B0 


EN%BLN== 


1B1 


EN%NST== 


1B2 


EN%LTL== 


1B3 


EN%LVL== 


777B17 


EN%JOB== 


777777B35 


EN%QCE== 


1B0 


EN%QCL== 


1B0 


EN%QCO== 


1B1 


EN%QCQ== 


1B2 


EN%QCT== 


1B2 


EN%QCX== 


1B3 


EN%QCB== 


1B4 



SHARABLE REQUEST 

BYPASS LEVEL NUMBEP 

ALLOW NESTING 

LONG TERM LOCK 

LEVEL NUMBER 

JOB NUMBER 

ERROR CODE IN RH OF STATUS WORD 

LOCK DUMP (.ENQCD ONLY) 

THIS FORK OWNS THE LOCK 

THIS FOPK IS IN THE QUEUE FOR THIS LOCK 

LOCK CONTAINS A TEXT STRING 

THE LOCK IS LOCKED EXCLUSIVELY 

USER IS BLOCKED FOR LOCK 



; ENQ/DEQ ARGUMENT BLOCK DATA STRUCTURE 



ENQLN== 


:0 






. ENHLN== 


:77B5 




. ENNLK== 


:7777B17 




. ENALN== 


:777777B35 


ENQID== 


:1 




ENQLV== 


:2 




ENQUC== 


:3 




ENQRS== 


:4 




ENQMS== 


:5 





# OF LOCKS , , LENGTH OF ARGUMENT BLOCK 
LENGTH OF HEADER AREA 

NUMBER OF LOCKS 

LENGTH OF ARGUMENT BLOCK 

PSI CHANNEL # ,, REQUEST ID 

FLAGS & LEVEL NUMBER ,, JFN, -1, -2, OR -3 

STRING POINTER OR USER CODE 

# OF RESOURCES IN POOL , , # OF RESOURCES WANT 
ADDRESS OF RESOURCE BLOCK 
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;ENQC DUMP DATA STRUCTURE 
.ENQDF==:0 



ENQDR== 
ENQDT== 
ENQDC=: 



ENQDI==:1 



;FLAGS + LEVEL # , , OFN, 400000+JOB #, -2, OR -3 
;OR: FLAGS + PS I # ,, JOB # OF Q-ENTRY CREATOR 

TOTAL RESOURCES IN POOL , , RESOURCES REMAINING 

TIME STAMP OF LAST REQUEST LOCKED 

USER CODE OF LOCK OR START OF TEXT STRING 



; GROUP # OR # REQUESTED 



ENQ ID 



;FLOUT/DFOUT 

; FORMAT CONTROL WORD 



FL%SGN==: 


3B1 


.FLDIG== 


:0 


.FLSPC== 


:1 


.FLPLS== 


:2 


.FLSPA== 


:3 


FL%JUS==: 


3B3 


.FLLSP== 


:0 


.FLLZR== 


:1 


.FLLAS== 


:2 


.FLTSP== 


:3 


FL%ONE==: 


1B4 


FL%DOL==: 


1B5 


FL%PNT==: 


1B6 


FL%EXP==: 


3B8 


.FLEXN== 


:0 


.FLEXE== 


:1 


.FLEXD== 


:2 


.FLEXM== 


:3 


FL%ESG==: 


3B10 


.FLDGE== 


:0 


.FLPLE== 


:1 


.FLSPE== 


:2 


.FLDGT== 


:3 


FL%OVL==: 


IB. 11 


FL%RND==: 


37B17 


FL%FST==: 


7 7B23 


FL%SND==: 


77B29 


FL%THD==: 


77B35 



FIRST FIELD SIGN CONTROL 

DIGIT 

SPACE 

PLUS SIGN 

SPACE 

FIRST FIELD JUSTIFICATION CONTROL 

LEADING SPACES 

LEADING ZEROS 

LEADING ASTERISKS 

TRAILING SPACES 

FIRST FIELD NONBLANK 

DOLLAR SIGN PREFIX 

DECIMAL POINT 

THIRD FIELD EXPONENT CONTROL 

NO EXPONENT 

E EXPONENT PREFIX 

D EXPONENT PREFIX 

*10~ EXPONENT PREFIX 

EXPONENT SIGN CONTROL 

DIGIT 

PLUS SIGN 

SPACE 

DIGIT 

COLUMN OVERFLOW 

DIGIT POSITION FOR ROUNDING 

FIRST FIELD WIDTH 

SECOND FIELD WIDTH 

THIRD FIELD WIDTH 
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;GDSTS 

;SEE MTOPR FOR CARD READER AND LINE PRINTER STATUS BITS 

;SEE GENERAL FIELD AND VALUE SECTION FOR MAGTAPE STATUS BITS 

;SEE TOPS20AN SECTION FOR NETWORK STATUS BITS 



.GDFSM==:17B3 
;TTY BITS 
GD%PAR==:1B35 



;TOPS20AN ;FINITE MACHINE STATE 



;IF ON, TERMINAL ACCEPTS PARITY 



;GET 



;Argument block for GET 



GFLAG= 


= :0 






GT%LOW== 


1B0 ; 




GT%HGH== 


1B1 




GT%BAS== 


1B2 ; 




GT%CCH== 


1B3 ; 




GT%CSH== 


1B4 ; 




GT%ADR== 


1B19 




GT%PRL== 


1B20 ; 




GT%NOV== 


1B21 




GT%ARG== 


1B22 




GT%JFN== 


7777B35 


GLOW== 


:1 




GHIGH= 


= :2 




GBASE= 


= :3 





FLAG WORD 

USE LOW ADDRESS IN .GLOW 
USE HIGH ADDRESS IN .GHIGH 
USE BASE SECTION IN .GBASE 
CLEAR PROGRAM CACHE 
CACHE THIS PROGRAM 

(IN AC1) USE ADDRESS LIMITS IN AC2 

(IN AC1) PRELOAD PAGES 

(IN AC1) DON'T OVERLAY EXISTING PAGES 

(IN AC1) IF ON, AC2 CONTAINS ADDRESS 

OF ARG BLOCK 
; (IN AC1) JFN 

LOW ADDRESS IF GT%LOW ON 
HIGH ADDRESS IG GT%HGH ON 
BASE IF GT%BAS ON 
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. JOBTT= 
. JOBRT= 
.TICKP= 
. JOBDI= 
.TTYJO= 
.NCPGS= 
.DEVNA= 
.DEVCH= 
.DEVUN= 
.DSKER= 
.DRMER= 
.SYSVE= 
.SYSTA= 
.QTIME= 
. JOBNA= 
.SNAME= 
.STIME= 
.SPFLT= 
.SSIZE= 
.SNBLK= 
.DBUGS= 
.LOGDE= 
.PTYPA= 
.SYMTA= 
.DWNTI = 
. JOBPN= 
.BLDTD= 
.LSTDR= 
.APRID= 
.HQLAV= 
. LQLAV= 
.NETRD= 
.IMPHR= 
.HSTST= 
.HSTNA= 
.HOSTN= 
.NETLS= 
.NETFS= 
.NETAW= 
.NETBA= 
.NETST= 
.NETBU= 
.NETBT= 
,IMPL1= 
.IMPL2= 
.IMPL3= 
.IMPL4= 
.LHOST= 
. JBONT= 
.NSWPG= 
.SCOUN= 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 

50 

51 

52 

53 

54 

55 

56 

57 

60 

61 

62 



TOPS 2 AN 
TOPS 2 AN 
TOPS2 0AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 
TOPS20AN 



JOB NUMBER TO TTY NUMBER 

JOB RUNTIME 

TICKS PER SECOND 

JOB NUMBER TO DIRECTORY NUMBERS (OBS] 

TTY NUMBER TO JOB NUMBER 

NUMBER PHYSICAL CORE PAGES 

DEVICE NAME 

DEVICE CHARACTERISTICS 

DEVICE UNIT NUMBERS 

DISK ERROR WORDS 

DRUM ERROR WORDS 

VERSION TEXT 

STATISTICS 

SCHED QUEUE TIMES 

JOB NUMBER TO PROGRAM NAME 

SUBSYSTEM NAME 

" TIME 

" PAGE FAULTS 

" SIZE INTEGRAL 

" NUMBER WAKEUPS 
DBUGSW, DCHKSW 
LOG, JOB DESIGNATORS 
PTY PARAMETERS 
GTTAB SYMBOL TABLE 
HSYS VARIABLES 
JOB NUMBER TO PROGRAM NAME 
MONITOR BUILD TIME AND DATE 
LAST DIR NUMBER ASSIGNED (OBS) 
APR SERIAL NUMBER 
HIGH QUEUE LOAD AVERAGES 
LOW QUEUE LOAD AVERAGES 
ARPANET STATUS 
HOST READY 
DEAD HOST STATUS 
HOST NAMES 
HOST NAME INDEX 
LOCAL SOCKET 
FOREIGN SOCKET 
ARPA CONNECTION ADDRESS 
BIT ALLOCATION 
CONNECTION STATUS 
ARPANET BUFFERS 
BYTE COUNT STATISTICS 
IMP LINK TABLE ONE 
IMP LINK TABLE TWO 
IMP LINK TABLE THREE 
IMP LINK TABLE FOUR 
LOCAL HOST NUMBER 
OWNING JOB 

DEFAULT SWAPPING PAGES 
COUNT SNAMES TABLE 
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. JIJNO= = 





. JITNO = = 


1 


. JIUNO = = 


2 


.JIDNO== 


3 


. JISNM = = 


4 


. JIPNM= = 


5 


. JIRT==:6 


.JICPJ== 


7 


. JIRTL== 


10 


.JIBAT== 


11 


.JIDEN== 


■12 


. JIPAR== 


13 


.JIDM==:14 


. JIRS==:15 


. JIDFS== 


16 


. JILNO== 


17 


. JISRM== 


20 


. JILLN== 


:21 


. JISRT== 


22 


. JISCT== 


.23 


. JIT20== 


:24 


. JISTM== 


:25 


. JIBCH== 


:26 


OB%WTO==3Bl 


.OBALL==0 


.OBNWR==l 


.OBNOM==2 


OB%BSS==1B10 


0B%BSN==177B17 


. JILLO==:27 


. JIMAX== 


: . JILLO 



JOB NUMBER 

TERMINAL NUMBER 

USER NUMBER 

DIRECTORY NUMBER 

SUBSYS NAME 

PROGRAM NAME 

RUN TIME 

CONTROLLING PTY JOB NUMBER 

RUN TIME LIMIT (SET BY TIMER JSYS) 

CONTROLLED BY BATCH 

MAGTAPE DEFAULT DENSITY 

MAGTAPE DEFAULT PARITY 

MAGTAPE DEFAULT DATA MODE 

MAGTAPE DEFAULT RECORD SIZE 

DEFERRED SPOOLING 

LOGGED-IN DIRECTORY NUMBER 

POINTER TO JOB SESSION REMARK 

LAST LOGIN DATE & TIME 

JOB RUNTIME AT START OF THIS ACCOUNTING SESS1 

JOB CONSOLE TIME AT START OF THIS SESSION 

-1 IF AT TOPS20 COMMAND LEVEL 

DATE & TIME JOB WAS INITIALIZED 

BATCH STREAM AND FLAGS 

WRITE TO OPERATOR CAPABILITIES 

WTO AND WTOR ALLOWED 

NO WTOR ALLOWED 

NO MESSAGE ALLOWED 

BATCH STREAM NUMBER SET 

BATCH-STREAM NUMBER 

LOGICAL LOCATION (NODE NAME) 

;CURRENT HIGHEST GETJI OFFSET 



;GFRKS 



GF%GFH= 
GF%GFS= 



1B0 
1B1 



;GET RELATIVE FORK HANDLES 
;GET FORK STATUS 



;GFUST 



,GFAUT= 
.GFLWR: 



;GET FILE AUTHOR 

;GET FILE LAST WRITER 



;GTHST 



;TOPS2 0AN 



•GTHSZ= 
.GTHIX= 
.GTHNS= 
.GTHSN= 
.GTHHN= 
.GTHHI= 



HOST TABLE SIZES 
INDEX TO STRING CONVERSION 
NUMBER TO STRING CONVERSION 
STRING TO NUMBER CONVERSION 
HOST NUMBER TO STATUS 
HOST INDEX TO STATUS 
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;GETOK DEFINITIONS 


.GOASD==:l 


.GEERB==:0 


.GEADD==:1 


.GOCAP==:2 


.GENCP==:1 


.GOCJB==:3 


.GOLOG==:4 


.GELUN==:1 


.GOCFK==:5 


.GEFCT==:1 


.GOTBR==:6 


,GELIN==:1 


.GESPD==: 2 


.GOLGO==:7 


.GEUSD==:1 


.GEQUO==:2 


.GERLG==:3 


.GOENQ==:10 


.GEEQU==:1 


.GEEUN==:2 


.GOCRD==:ll 


.GOSMT==:12 


.GESDE==:1 


.GOMDD==:13 


,GOCLS==:14 


.GEJOB==:l 


.GECLS==:2 


.GOCL0==:15 


.GOMTA==:16 


.GEACC==:1 


.GEUSN== 


2 


.GEUNT== 


3 


.GEACD== 


4 


.GELTP== 


5 


.GOACC==:17 


.GOAC0==: 1 


.GOACl==: 2 


.GOOAD==:20 


.GODNA==:21 


.GOANA==: 22 


.GOATJ==:23 


.GOTJB==:l 


.GO r 


PTY==:2 



ASSIGN DEVICE 

ERROR BLOCK ADDRESS 

DEVICE DESIGNATOR 

ENABLE CAPABILITIES 

NEW CAPABILITIES 

ALLOW CRJOB JSYS 

ALLOW LOGINS 

USER NUMBER 

ALLOW CFORK JSYS 

NUMBER OF FORKS 

ALLOW SET TERMINAL BAUD RATE 

LINE NUMBER 

SPEED 

ALLOW LOGOUT 

PAGES USED 

QUOTA 

JOB TO BE LOGGED OUT, -1 FOR CALLER 

ALLOW SET ENQ QUOTA 

DESIRED QUOTA 

JOB NUMBER 

ALLOW CREDIR 

ALLOW SMOUNT 

DEVICE DESIGNATOR 

ALLOW MDDT ENTRY 

VERIFY CLASS ASSIGNMENT FOR A JOB 

JOB # 

CLASS DESIRED 

SET CLASS AT LOGIN 

MT ACCESS REQUEST 

ACCESS CODE FROM HDR1 

USER NUMBER 

MT UNIT NUMBER 

DESIRED ACCESS (BITS) 

LABEL TYPE 

ACCESS AND CONNECT 

FLAGS FROM ACESS JSYS 

DIRECTORY NUMBER 

ASSIGN DUE TO OPENF 

.GEADD IS THE ARG OFFSET FOR THE 

DEVICE DESIGNATOR 
ACCESS TO DECNET 
ACCESS TO ARPANET 

ATACH JSYS 
TAGET JOB NUMBER 
SOURCE TTY NUMBER 



,GOKMZ==:~D20 

; ERROR BLOCK ADDRESS OFFSETS 



;MAX ARGUMENT BLOCK SIZE FOR GETOK REQUEST 



,GESIZ== 
,GEERN=: 
GEPTR=: 
GEBSZ== 



SIZE OF THIS BLOCK 
ERROR NUMBER 
POINTER TO ERROR STRING 
STRING SIZE 



B-33 



MONSYM 



;GTJFN DEFINITIONS 

; FLAGS PROVIDED TO GTJFN ON CALL 



GJ%FOU== 


:1B0 


GJ%NEW== 


:1B1 


GJ%OLD== 


:1B2 


GJ%MSG== 


:1B3 


GJ%CFM== 


:1B4 


GJ%TMP== 


:1B5 


GJ%NS==:: 


LB6 


GJ%ACC== 


■1B7 


GJ%DEL== 


1B8 


GJ%JFN== 


:3B10 


.GJDNU== 





•GJERR== 


2 


.GJALT== 


3 


GJ%IFG== 


1B11 


GJ%OFG== 


1B12 


GJ%FLG== 


1B13 


GJ%PHY== 


1B14 


GJ%XTN==: 


1B15 


GJ%FNS==: 


1B16 


GJ%SHT==: 


1B17 



FILE IS FOR OUTPUT USE 

NEW FILE ONLY 

OLD FILE ONLY 

PRINT AN APPROPRIATE MESSAGE 

CONFIRMATION IS REQUIRED 

TEMPORARY 

DONT SEARCH SEARCH LISTS 

NO ACCESS BY OTHER FORKS 

IGNORE "DELETED" BIT 

JFN USE FIELD 

DO NOT USE JFN PROVIDED 

ERROR IF CANNOT USE JFN PROVIDED 

USE ALTERNATE IF CANNOT USE GIVEN JFN 

ACCEPT INPUT FILE GROUP DESCRIPTORS 

ACCEPT OUTPUT FILE GROUP DESCRIPTORS 

RETURN FLAGS 

PHYSICAL DEVICE ONLY 

EXTENDED FORMAT (E+ll EXISTS) 

ACCUMULATOR 2 CONTAINS JOB FILE NUMBERS 

SHORT CALL FORMAT 



; FLAGS PROVIDED TO GTJFN (IN SECOND FLAG WORD) 



G1%RND== 


:1B0 


G1%RBF== 


1B1 


G1%NLN== 


1B2 


G1%RCM== 


1B3 


G1%RIE== 


1B4 


G1%IIN== 


1B5 


G1%SLN== 


1B6 



RETURN ON NULL (IN ALTERNATE FLAG WORD) 

~R BUFFER IS DISJOINT (OBSOLETE) 

NO LONG NAMES 

RETURN CONFIRM MESSAGE 

RETURN WHEN MAIN STRING IS EMPTY 

Ignore invisible status 
SUPPRESS EXPANSION OF LOGICAL NAMES 
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; FLAGS RETURNED BY GTJFN 



MONSYM 



GJ%DEV== 


1B0 


GJ%UNT== 


1B1 


GJ%DIR== 


1B2 


GJ%NAM== 


1B3 


GJ%EXT== 


1B4 


GJ%VER== 


1B5 


GJ%UHV== 


1B6 


GJ%NHV== 


1B7 


GJ%ULV== 


1B8 


GJ%PRO== 


1B9 


GJ%ACT== 


1B10 


GJ%TFS== 


1B11 


GJ%GND== 


1B12 


GJ%GIV== 


1B17 



ASTERISK WAS GIVEN FOR DEVICE 
ASTERISK WAS GIVEN FOR UNIT 
ASTERISK WAS GIVEN FOR DIRECTORY 
ASTERISK WAS GIVEN FOR NAME 
ASTERISK WAS GIVEN FOR EXTENSION 
ASTERISK WAS GIVEN FOR GENERATION 
USE HIGHEST GENERATION 
USE NEXT HIGHER GENERATION 
USE LOWEST GENERATION 
PROTECTION GIVEN 
ACCOUNT GIVEN 

TEMPORARY FILE SPECIFIED (;T) 
COMPLEMENT OF GJ%DEL ON CALL 
Comp of G1%IIV 



;GTJFN TABLE OFFSETS 



.GJGEN== 







.GJDEF== 


<Z 


0> 


.GJNHG== 


<Z 


-1> 


.GJLEG== 


<Z 


-2> 


.GJALL== 


<Z 


-3> 


.GJSRC== 


1 




.GJDEV== 


2 




.GJDIR== 


3 




.GJNAM== 


4 




.GJEXT== 


5 




.GJPRO== 


6 




.GJACT== 


•7 




.GJJFN== 


10 




.GJF2==:! 


LI 




.GJCPP== 


12 




.GJCPC== 


:13 




.GJRTY== 


:14 




.GJBFP== 


:15 




.GJATR== 


16 




.GJNOD== 


:17 





FLAGS , , GENERATION 

DEFAULT GENERATION 

NEXT HIGHER GENERATION 

LOWEST EXISTING GENERATION 

ALL GENERATIONS (I.E., ;*) 

SOURCE JFN , , OUTPUT JFN 

DEFAULT DEVICE 

DEFAULT DIRECTORY 

DEFAULT NAME 

DEFAULT EXTENSTION 

DEFAULT PROTECTION 

DEFAULT ACCOUNT 

DESIRED JFN 

SECOND GROUP FLAGS,, COUNT 

COPY BUFFER POINTER 

COPY BUFFER COUNT 

RETYPE (~R) POINTER 

TOP OF BUFFER POINTER 

POINTER TO ARBITRARY ATTRIBUTE BLOCK 

DEFAULT NODE 



;GNJFN - FLAGS RETURNED 



GN%STR== 


1B13 


GN%DIR== 


1B14 


GN%NAM== 


1B15 


GN%EXT== 


1B16 



STRUCTURE CHANGED 
DIRECTORY CHANGED 
NAME CHANGED 
EXTENSION CHANGED 



;GTNCP 



;TOPS20AN 



•GTNSZ== 





.GTNIX== 


1 


.GTNNI== 


2 


.GTNNO== 


3 


.GTNJF== 


4 


.NCIDX== 





,NCFHS== 


1 


.NCLSK== 


2 


.NCFSK== 


3 


.NCFSM== 


4 


.NCLNK== 


5 


.NCNVT== 


:6 


.NCSIZ== 


:7 



SIZE OF TABLE 
NCP INDEX 
NVT INPUT 
NVT OUTPUT 
JFN 

NCP INDEX 

FOREIGN HOST 

LOCAL SOCKET 

FOREIGN SOCKET 

FINITE STATE MACHINE STATE 

LINK 

NVT, -1 IF NOT A TELNET CONNECTION 

BYTE SIZE OF CONNECTION 
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MONSYM 



,NCMSG== 
,NCBAL= = 
,NCDAL== 
,NCBTC== 
,NCBPB== 
,NCCLK== 
,NCSTS== 



10 
11 
12 
13 
14 
15 
16 



MSG ALLOC 
BIT ALLOC 
DESIRED ALLOC 
BITS XFERRED 
BYTES/BUFFER 
TIME-OUT COUNTDOWN 
CONNECTION STATUS 



B-36 



MONSYM 



;GTRPW 

PF%USR= 
PF%WTF= 
PF%WRT= 
TSW%RD= 
TSW%WT= 
TSW%WR= 
TSW%EX= 
TSW%MN= 



1B0 

1B1 

1B5 

1B14 

1B15 

1B15 

1B16 

1B17 



PAGE FAIL WORD - USER MODE REFERENCE 

" - WRITE REFERENCE (XGTPW) 

" - WRITE REFERENCE 
TRAP STATUS WORD - READ 

" - WRITE 

(ANOTHER NAME FOR ABOVE) 

" - EXECUTE 

" - MONITOR MODE REFERENCE 



;GTSTS BITS RETURNED IN 2 



GS%OPN== 


1B0 




GS%RDF== 


1B1 




GS%WRF== 


1B2 




GS%XCF== 


1B3 




GS%RND== 


1B4 




GS%APT== 


1B5 




GS%CAL== 


1B6 




GS%LNG== 


1B7 




GS%EOF== 


1B8 




GS%ERR== 


1B9 




GS%NAM== 


.1B10 




GS%AST== 


1B11 




GS%ASG== 


1B12 




GS%HLT== 


1B13 




GS%FRK== 


1B17 




GS%PLN== 


1B18 




GS%MOD== 


17B35 






GSNRM== 







,GSSMB== 


1 




GSIMG== 


10 




,GSDMP== 


17 



FILE IS OPEN 

IF OPEN, FILE IS OPEN FOR READ 
IF OPEN, FILE IS OPEN FOR WRITE 
IF OPEN, FILE IS OPEN FOR EXECUTE 
OK TO RESET BYTE POINTER 

(FILE IS NOT APPEND) 
ACCESS PER PAGE TABLE 

(NOT IMPLEMENTED — OBSOLETE) 
OK TO CALL AS A PROCEDURE 

(NOT IMPLEMENTED -- OBSOLETE) 
FILE IS LONG 
AT END OF FILE ON READ 
FILE MAY BE IN ERROR 
FILE HAS A NAME (JFN EXISTS) 
ONE OR MORE FIELDS OF NAME 

IS WILD 
JFN IS BEING ASSIGNED 
TERMINATE ON I/O ERROR 
JFN IS RESTRICTED TO CREATING FORK 
DON'T STRIP LINE NUMBERS ON SIN/BIN 
DATA MODE 

NORMAL MODE 

SMALL BUFFER MODE (DCN:, SRV:) 

IMAGE (BINARY) MODE 

DUMP MODE 
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;HPTIM 

.HPELP==:0 
.HPRNT==:1 



; ELAPSED TIME 
;RUN TIME 



;IDCNV (ALSO IDTNC AND ODCNV) 



IC%DSA== 


1B0 


IC%ADS== 


1B1 


IC%UTZ== 


1B2 


IC%JUD== 


1B3 


IC%TMZ== 


77B17 



IC%TIM==777777B35 



DAYLIGHT SAVINGS IF APPROPRIATE 

APPLY DAYLIGHT SAVINGS 

USE TIME ZONE GIVEN 

USE JULIAN DATE CONVERSION 

TIME ZONE 

LOCAL TIME 



;IDTIM & IDTNC 



IT%NDA== 


:1B0 


IT%NNM== 


:1B1 


IT%SNM== 


:1B2 


IT%ERR== 


■1B3 


IT%NTI== 


•1B6 


IT%NIS== 


1B7 


IT%AIS== 


1B8 


IT%NAC== 


1B9 


IT%AAC== 


1B10 


IT%AMS== 


1B11 


IT%AHM== 


1B12 


IT%N24== 


1B14 


IT%NTM== 


1B15 


IT%NTZ== 


1B16 



NO DATE 

NO NUMERIC MONTH 

SECOND NUMBER IS MONTH 

ERROR IF NUMBERS ARE NOT IN SPECIFIED 

ORDER 
NO TIME 
NO SECONDS 

ALWAYS INCLUDE SECONDS 
NO COLON ALLOWED BETWEEN HH AND MM 
ALWAYS ALLOW COLON 

ALWAYS INTERPRET ONE COLON AS HHMM:SS 
ALWAYS INTERPRET ONE COLON AS HH:MM 
NO 24-HOUR FORMAT 
NO TIME MODIFIER (AM, PM) 
NO TIME ZONE 



;.IMOPR - MONITOR ROUTINE USED BY MDDT AND SNOOP. 
;A JSYS SO THAT CALLS ARE FAST. 



THIS IS NOT 



IMALC== 
IMMAP== 
IMUMP== 



ALLOCATE PAGES FOR USE IN MAPPING SYMBOLS 
MAP PAGES OF THE SYMBOL TABLE 
UNMAP PAGES OF THE SYMBOL TABLE 



;INLNM 

.INLJB==:0 
. INLSY==:1 



;GET JOB WIDE LOGICAL NAME FROM INDEX 
;GET SYSTEM LOGICAL NAME FROM INDEX 
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;IPCF BIT DEFINITIONS AND DATA STRUCTURES 
; PACKET FORMAT 



.IPCFL== 





IP%CFB== 


1B0 


IP%CFS== 


1B1 


IP%CFR== 


1B2 


IP%CFO== 


1B3 


IP%TTL== 


1B4 


IP%CPD== 


1B5 


IP%JWP== 


1B6 


IP%NOA== 


1B7 


IP%CFP== 


1B18 


IP%CFV== 


1B19 


IP%CFZ== 


:1B20 


IP%INT== 


1B21 


IP%EPN== 


1B22 


IP%CFE== 


77B29 



; ERRORS SENT BY INFO 



. IPCPI== 


:15 


. IPCUF== 


:16 


•IPCSN== 


:67 


. IPCFF== 


:72 


.IPCBP== 


:74 


.IPCDN== 


:75 


.IPCNN== 


:76 


.IPCEN== 


:77 


.IPCKM== 


:66 


IP%CFC==: 


7B32 


. IPCCC== 


:1 


.IPCCF== 


:2 


.IPCCP== 


:3 


IP%CFM==: 


7B35 


.IPCFN== 


:1 


.IPCFS==: 


1 


.IPCFR==: 


2 


. IPCFP==: 


3 


.IPCFD==: 


4 


.IPCFC==: 


5 


. IPCSD==: 


6 


.IPCAS==: 


7 


. IPCLL==: 


10 



FLAGS WORD 

DON'T BLOCK READ 

INDIRECT SENDER'S PID 

INDIRECT RECEIVER'S PID 

OVERDRAW SEND 

TRUNCATE ON TOO LARGE MESSAGE 

CREATE A PID ON THE SEND 

MAKE THE CREATED PID BE JOB WIDE 

NO ACCESS OF PID BY OTHER FORKS 

SENDER IS PRIV'D AND IS ENVOKING PRIVS 

PAGE TRANSFER MODE 

ZERO LENGTH MESSAGE WAS SENT 

Internal call - unavailable to users 
PAGE NUMBER IS 18 BITS 
ERROR FIELD 



INSUFFICIENT PRIVILEGE 

ILLEGAL FUNCTION 

SEND INFO YOUR NAME 

INFO FREE SPACE EXHAUSTED 

PID HAS NO NAME OR IS ILLEGAL 

DUPLICATE NAME 

UNKNOWN NAME 

ILLEGAL NAME 

NOTIFICATION THAT PID HAS BEEN DELETED 

SYSTEM SENDER CODE 

SENT BY [SYSTEM] IPCF 

SENT BY SYSTEM WIDE [SYSTEM] INFO 

SENT BY RECEIVER'S [SYSTEM] INFO 

SPECIAL MESSAGE RETURN FIELD 

MESSAGE WAS NOT DELIVERED 

PID OF SENDER 

PID OF RECEIVER 

POINTER TO MESSAGE BLOCK 

LOGGED IN DIR OF SENDER 

ENABLED CAPABILITIES OF SENDER 

CONNECTED DIRECTORY NUMBER OF SENDER 

POINTER TO ACCOUNT STRING OF SENDER 

POINTER TO LOGICAL LOCATION OF SENDER 



;Possible values in word of packet data block when received from the system 



IPCSU- 
IPCSL= 
IPCSA= 
IPCDS= 
IPCLI= 
IPCLO= 
IPCKP= 
IPCCA= 
IPCTR= 
IPCMS= 
IPCRS= 
IPCSR; 



26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 



IPCSS==:15 



SPOOL MESSAGE CODE FROM IPCC 
LOGOUT MESSAGE CODE FROM IPCC 
RESOURCE ALLOCATOR MESSAGE CODE 
STRUCTURE DISMOUNT MESSAGE CODE FROM IPCC 
LOGIN MESSAGE CODE FROM IPCC 
LOGOUT MESSAGE TO CREATOR FROM IPCC 
DELETED PID MESSAGE FROM IPCC 

CREATE AN APPLICATION (RESERVED FOR TPS USE) 
REQUEST FROM TAPE 

STRUCTURE MOUNT MESSAGE CODE FROM IPCC 
STRUCTURE REMOVAL MSSG CODE FROM IPCC 
Archive message code from IPCC 

;IPCC REQUEST TO INFO TO DELETE PIDS 
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; [SYSTEM] INFO DEFINITIONS 



MONSYM 



IPCI0== 





IPCIW== 


1 


IPCIG== 


2 


IPCII== 


3 


IPCIJ== 


4 


IPCIK== 


5 


IPCIS== 


15 


IPCI1== 


1 


IPCI2== 


2 



CODE, , FUNCTION 

FIND PID FOR NAME 

FIND NAME FOR PID 

ASSIGN NAME TO PID 

ASSIGN NAME TO PID 

NOTIFY WHEN SPECIFIED PID IS KILLED 

MONITOR DROP PID FUNCTION 

PID TO GET A COPY OF REPLY 

START OF DATA 



;JFNS 



JS%DEV== 


7B2 


JS%DIR== 


7B5 


JS%NAM== 


7B8 


JS%TYP== 


7B11 


JS%GEN== 


7B14 


JS%PRO== 


7B17 


JS%ACT== 


7B20 




VALUES FOR ABOVE 




JSNOF==:0 




JSAOF==:l 




JSSSD==:2 


JS%TMP== 


1B21 


JS%SIZ== 


1B22 


JS%CDR== 


1B23 


JS%LWR== 


1B24 


JS%LRD== 


1B25 


JS%PTR== 


1B26 


JS%ATR== 


1B27 


JS%AT1== 


1B28 


JS%OFL== 


1B29 


JS%PSD== 


1B32 


JS%TBR== 


1B33 


JS%TBP== 


1B34 


JS%PAF== 


1B35 



DEVICE FIELD OUTPUT CONTROL 
DIRECTORY FIELD OUTPUT CONTROL 

!NAME FIELD OUTPUT CONTROL 
FILE TYPE FIELD OUTPUT CONTROL 
GENERATION FIELD OUTPUT CONTROL 
PROTECTION FIELD OUTPUT CONTROL 
ACCOUNT FIELD OUTPUT CONTROL 
7 FIELDS: 

:NEVER OUTPUT FIELD 
ALWAYS OUTPUT FIELD 
SUPPRESS IF SYSTEM DEFAULT 
RETURN ;T IF TEMP FILE 
RETURN SIZE 
RETURN CREATION DATE 
RETURN LAST WRITE 
RETURN LAST READ 

'AC 2 HOLDS STRING POINTER NOT JFN 
RETURN ATTRIBUTES 
RETURN 1 SPECIFIC ATTRIBUTE 
RETURN ;OFF-LINE IF OFFLINE FILE 
PUNCTUATE SIZE AND DATE 
TAB BEFORE FIELDS RETURNED 
TAB BEFORE POSSIBLE FIELDS 
PUNCTUATE ALL FIELDS 



JS%SPC==:<FLD( . JSAOF , JS%DEV) >!<FLD( . JSAOF , JS%DIR) >!<FLD( . JSAOF , JS%NAM) >! ~_ 
<FLD( . JSAOF, JS%TYP) >!<FLD(. JSAOF ,JS%GEN) >! JS%PAF ;MASK FOR WHOLE SPEC 

,-LNMST 



LNSJB==:0 
LNSSY==:1 



;GET JOB WIDE DEFINITION OF A LN 

;GET SYSTEM DEFINITION OF A LOGICAL NAME 



; LOCK 



LK%CNT== 
LK%PHY= : 
LK%NCH== 
LK%AOL== 



1B0 
1B1 
1B2 
1B3 



USE COUNT IN AC3 

USE AC1 AS PHYSICAL PAGE NUMBER 
MAP PAGES CACHE INHIBITED 
ALLOW LOCKING IN OFFLINE PAGES 



;METER JSYS DEFS 



.MEREA==:1 
. MERMA==: 2 



;READ EBOX TICKS 
;READ MBOX TICKS 
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;MSTR 



MONSYM 



.MSRNU==:0 






.MSRUS==:1 






.MSRCH== 







•MSRCT== 


1 




.MSRUN== 


2 




.MSRST== 


3 




MS%MNT= 


= =: 


1B0 


MS%16B= 


= = : 


1B1 



MS%DIA==:1B2 



MS%OFL= 


: = 


1B3 


MS%ERR== 


1B4 


MS%BBB== 


1B5 


MS%HBB== 


1B6 


MS%WLK== 


1B7 


MS%TYP== 


7 77B17 


DEFINED THE SAME AS 


.MSRP4== 


1 


.MSRP5== 


:5 


.MSRP6== 


6 


.MSRP7== 


:7 


.MSRM3== 


:11 


.MSR20== 


24 


•MSRSN== 


4 


.MSRSA== 


5 


.MSRNS== 


6 


.MSRSW== 


7 


.MSRUI== 


10 


.MSROI== 


13 


.MSRFI== 


16 


.MSRSP== 


21 


.MSRSC== 


22 


.MSRPC== 


23 


.MSRCU== 


24 


.MSRSU== 


25 


.MSRBT== 


26 


.MSRSE== 


27 


.MSRLN== 


3( 


D 



READ STATUS OF NEXT DISK UNIT 

READ STATUS OF A DISK UNIT 

CHANNEL NUMBER 

CONTROLLER NUMBER 

UNIT NUMBER 

STATUS 

THIS UNIT IS PART OF A MOUNTED STRUCTURE 

THIS UNIT WRITTEN IN 16-BIT MODE 
(RESERVED FOR FUTURE) 

THIS UNIT IS CURRENTLY IN USE BY AN 
ON-LINE DIAGNOSTIC 

THIS UNIT IS OFF-LINE 

THERE WAS AN ERROR READING THIS UNIT 

ONE OF THE BAT BLOCKS IS BAD 

ONE OF THE HOME BLOCKS IS BAD 

UNIT IS WRITE-LOCKED 

DISK TYPE CODE 
UTTXX IN PHYPAR 

RP0 4 

RP0 5 

RP0 6 

RP07 

RM0 3 

RP20 

STRUCTURE NAME 

STRUCTURE ALIAS 

UNIT # IN STRUCTURE,,* OF UNITS IN STRUCTURE 
:NUMBER OF PAGES FOR SWAPPING 

UNIT ID 

OWNER ID 

FILE-SYSTEM ID 
•NUMBER OF SECTORS PER PAGE 
iNUMBER OF SECTORS PER CYLINDER 
;NUMBER OF PAGES PER CYLINDER 
iNUMBER OF CYLINDERS PER UNIT 
:NUMBER OF SECTORS PER UNIT 
^NUMBER OF BIT-WORDS IN BIT TABLE PER CYLINDER 

CPU SERIAL # IF STRUCTURE IS USED FOR BOOTING 

MAX LENGTH OF ARGUMENT BLOCK IN WORDS 
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MSMNT==:2 






.MSTNM== 







.MSTAL== 


1 




.MSTNU==- 


2 




.MSTFL== 


2 




MS%FLG== 


777777, ,0 


MS%NFH== 


1B0 


MS%NFB== 


1B1 


MS%XCL== 


1B2 


MS%IGN== 


1B3 


.MSTUI==:3 




.MSTCH== 





.MSTCT== 


1 


•MSTUN== 


2 


.MSTNO== 


3 


MSDIS==:3 




.MSDNM==:0 




MSGSS==:4 




.MSGSN==:0 




.MSGST==:1 




MS%PS==:1 


LBO 


MS%DIS== 


1B1 


MS%DOM== 


1B2 


MS%PPS== 


1B3 


MS%INI== 


1B4 


MS%LIM== 


1B5 


MS%NRS== 


1B6 


MS%RWS== 


1B7 


MS%RWD== 


1B8 


•MSGNU== 


2 




.MSGMC== 


3 




•MSGFC== 


4 




.MSGSI== 


5 




.MSGLN== 


6 




MSSSS==:5 




.MSSSN== 







.MSSST== 


1 




.MSSMW== 


2 




•MSSLN== 


3 





MOUNT A STRUCTURE 

NAME OF STRUCTURE 

ALIAS NAME 

NUMBER OF UNITS IN STRUCTURE 

FLAGS (LHS) 

MASK FOR .MSTFL 

NO FIX BAD HOME BLOCK 

NO FIX BAD BAT BLOCK 

MOUNT FOR EXCLUSIVE USE BY JOB 

IGNORE ERRORS 

START OF UNIT INFORMATION 

CHANNEL NUMBER 

CONTROLLER NUMBER 

UNIT NUMBER 

# OF ARGUMENT WORDS/UNIT 

; DISMOUNT A STRUCTURE 
;NAME OF STRUCTURE 

GET STATUS OF A STRUCTURE 
STRUCTURE NAME (ALIAS) 
STATUS 

IS A PUBLIC STRUCTURE 
IS BEING DISMOUNTED 
IS DOMESTIC 
IS THE PRIMARY PUBLIC 
IS BEING INITIALIZED 
STRUCTURE LIMITED TO 2050 SIZES 
STRUCTURE IS NOT REGULATED 
READ AFTER WRITE FOR SWAP SPACE 
READ AFTER WRITE FOR DATA SPACE 
NUMBER OF UNITS IN STRUCTURE 
MOUNT COUNT 
OPEN FILE COUNT 
STRUCTURE ID 
LENGTH OF ARGUMENT BLOCK 

SET STATUS OF A STRUCTURE 

STRUCTURE NAME 

NEW STATUS BITS 

MASK WORD OF BITS TO BE CHANGED 

LENGTH OF ARGUMENT BLOCK 



STRUCTURE 
STRUCTURE 
STRUCTURE 
STRUCTURE 
STRUCTURE 



STRUCTURE 
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MSINI==:6 
.MSINM== 
•MSIAL== 
.MSINU== 
.MSIFL== 



MS%FCN==:77B17 



.MSCRE== 
.MSRRD== 
.MSWHB== 
.MSRIX== 
.MSISU==:3 
.MSICH==:0 
.MSICT==:1 
.MSIUN==:2 
.MSINO==:3 
.MSIST==:6 
.MSISW==:7 
.MSIFE==:10 
.MSIUI==:11 
,MSIOI==:14 
.MSIFI==:17 
.MSIFB==:22 
.MSISN==:23 



INITIALIZE A STRUCTURE 

NAME OF STRUCTURE 

ALIAS NAME 

NUMBER OF UNITS IN STRUCTURE 

FLAGS (LHS) 

FLAGS DEFINED IN .MSMNT FUNCTION 

FUNCTION CODE 

CREATE NEW FILE SYSTEM 

RECONSTRUCT THE ROOT-DIRECTORY 

WRITE THE HOME BLOCKS 

;REBUILD INDEX TABLE (IDXFIL) 
START OF UNIT INFORMATION 
CHANNEL NUMBER 
CONTROLLER NUMBER 
UNIT NUMBER 

# OF ARGUMENT WORDS/UNIT 
STATUS WORD 

NUMBER OF PAGES FOR SWAPPING ON THIS UNIT 
NUMBER OF PAGES FOR FRONT-END FILE SYSTEM 
UNIT ID 
OWNER ID 
FILE SYSTEM ID 

NUMBER OF PAGES FOR BOOTSTRAP.BIN (OPTIONAL) 
CPU SERIAL # IF STRUCTURE IS USED FOR BOOTING 



MSIMC==:7 
MSDMC==:10 
.MSDEV==:0 
.MSJOB==:l 



INCREMENT MOUNT COUNT 

DECREMENT MOUNT COUNT 

DEVICE DESIGNATOR OR STRUCTURE 

JOB NUMBER FOR WHICH TO CHANGE COUNT 



B-43 



MONSYM 



MSGSU==:11 

.MSUAL==:0 

.MSUFL==:1 

MS%GTA== 

MS%GTM== 

MS%GTC== 

.MSUJ1==:2 



1B0 
1B1 
1B2 



GET STRUCTURE USERS 

POINTER TO ALIAS OF STRUCTURE 

FLAGS,, # OF ITEMS RETURNED 

GET USERS WHO HAVE ACCESSED STRUCTURE 

GET USERS WHO HAVE MOUNTED STRUCTURE 

GET USERS WHO ARE CONNECTED TO STRUCTURE 

FIRST JOB NUMBER RETURNED 



MSHOM==: 12 
.MSHNM== 
.MSHOF== 
.MSHVL== 
.MSHMK== 



MODIFY HOMEBLOCK WORD 

POINTER TO ALIAS, OR DESIGNATOR FOR ALIAS 

OFFSET INTO HOMEBLOCK OF WORD BEING CHANGED 

NEW VALUES FOR BITS BEING CHANGED 

MASK DECLARING WHICH BITS BEING CHANGED 



MSICF==:13 
MSDCF==:14 
.MSDEV==:0 



INCREMENT MOUNT COUNT ON A FORK BASIS 
DECREMENT MOUNT COUNT ON A FORK BASIS 
DEVICE DESIGNATOR OR STRUCTURE 



MSOFL==:15 



.MSCHN==:0 



ENABLE PSI INTERRUPTS INTERRUPTS FOR 

DISK (FOR DEVICE ALLOCATOR) 
CHANNEL ON WHICH TO RECEIVE INTERRUPT 



MSIIC==:16 



; IGNORE INCREMENT CHECK FOR STRUCTURE USE 
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;MTOPR - FUNCTION CODES 



MONSYM 



.MOCLE== 





.MONOP== 


31 


.MOREW==" 


1 


.MOEOF== 


3 


.MODTE== 


4 


.MOFWR== 


6 


.MOBKR== 


7 


.MORUL== 


11 


.MOERS==- 


13 


.MOFWF==- 


16 


.MOBKF== 


17 


.MOSPD== 


26 


.MORSP== 


27 


MO%RM'] 


r==:lB0 


MO%AU"] 


P==:1B1 


.MOSDR== 


2 


.MORDR== 


26 


.MOEOT== 


10 


.MOSRS== 


5 


.MORRS== 


15 


.MOSDN== 


24 


.MORDN== 


12 


.MOSDM== 


4 


.MORDM== 


:14 


.MOSPR== 


:20 


.MORPR== 


21 


.MONRB== 


22 


.MOFOU== 


23 


.MOINF== 


25 



.MOICT==:0 
.MOITP==:l 



; DEFINED THE i 


SAI^ 


IE AS 


.UTTXX IN F 


.MTT45== 


3 




.MTT77== 


13 




,MTT7 8== 


15 




.MTT70== 


17 




.MTT71== 


20 




.MTT72== 


21 




.MTT73== 


22 




.MOIID== 


2 




.MOISN== 


3 




.MOIRD== 


4 




.MOIWT== 


•5 




.MOIRC== 


•6 




.MOIFC== 


7 




.MOISR== 


10 




.MOISW== 


11 




.MOIHR== 


12 




•MOIHW== 


13 




.MOIRF== 


14 




•MOIWF== 


15 




.MOLOC==:32 




.MOCNT== 







.MOMTN== 


1 




.MOLBT== 


2 




.MODNS== 


3 




.MOAVL== 


4 




.MONVL== 


5 




.MOCVN== 


•6 




.MOA 


7SN= 


= = 


:7 





CLEAR ERRORS 

NOP (WAIT FOR ACTIVITY TO STOP) 

REWIND 

WRITE EOF 

ASSIGN FE DEVICE TO A DTE 

FORWARD SPACE RECORD 

BACKSPACE RECORD 

REWIND AND UNLOAD 

ERASE TAPE 

FORWARD SPACE FILE 

BACKSPACE FILE 

SET TTY SPEED (FOR KL ONLY) 

READ LINE SPEED (FOR KL ONLY) 

FLAG TO SAY LINE IS REMOTE 

FLAG TO SAY LINE IS "AUTO" SPEED 

(RSX20F ONLY) 
SET READ DIRECTION 
READ READ DIRECTION 
SKIP TO LOGICAL END OF TAPE 
SET RECORD SIZE 
READ RECORD SIZE 
SET DENSITY 
READ DENSITY 
SET DATA MODE 
READ DATA MODE 
SET PARITY 
READ PARITY 

GET NUMBER OF REMAINING BYTES IN RECORD 
FORCE OUT RECORD 
GET INFORMATION ABOUT TAPE 
COUNT OF ARGUMENTS TO BE RETURNED 
MAGTAPE TYPE CODE 
PHYPAR 
MAGTAPE TYPE TU45 
MAGTAPE TYPE TU7 7 
MAGTAPE TYPE TU78 
MAGTAPE TYPE TU70 
MAGTAPE TYPE TU71 
MAGTAPE TYPE TU72 

RESERVED FOR 200 IPS STC GCR DRIVE 
MAGTAPE REEL ID 
CHAN, CONTROLLER, UNIT ,, SERIAL # 

# OF READS DONE 

# OF WRITES DONE 
RECORD # FROM BOT 
FILE COUNT ON TAPE 

# OF SOFT READ ERRORS 

# OF SOFT WRITE ERRORS 

# OF HARD READ ERRORS 

# OF HARD WRITE ERRORS 

# RECORDS READ 

# OF FRAMES WRITTEN 
ATTACH MT TO MTA 
OFFSET FOR COUNT 
OFFSET FOR MT NUMBER 
LABEL TYPE ( .LTxxx) 
DENSITY (.SJDxx) 
ADDRESS OF VOLUME LABELS 

# OF VOLUME LABELS (VOLl + UVLSs) 
CURRENT VOLUME NUMBER WITHIN SET 
VOLUME SET NAME 
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MOSTA==:37 
.MODDN==:l 

SJ%CP2== 
SJ%CP5== 
SJ%CP8== 
SJ%C16== 
SJ%C62== 



1B1 
1B2 
1B3 
1B4 
1B5 



; CURRENT MAGTAPE STATUS 

;1ST WORD OF . MOSTA DENSITIES CAPABLE 

200 BPI 
556 BPI 
800 BPI 
1600 BPI 
6250 BPI 



MODDM==:2 
SJ%CMC==:1B1 
SJ%CM6==:1B2 
SJ%CMA==:1B3 
SJ%CM8==:1B4 
SJ%CMH==:1B5 

MOTRK==:3 
SJ%7TR==:1B1 
SJ%9TR==:1B2 



MOCST==:4 
SJ%OFS== 
SJ%MAI== 
SJ%MRQ== 
SJ%BOT== 
SJ%REW== 
SJ%WLK== 



1B0 
1B1 
1B2 
1B3 
1B4 
1B5 



2ND WORD OF .MOSTA DATA MODES CAPABLE 

CORE DUMP MODE 

SIXBIT 

ANSI ASCII 

INDUSTRY COMPATABLE 

HIGH DENSITY MODE 

3RD WORD OF .MOSTA NUMBER OF TRACKS 

7 TRACK DRIVE 

9 TRACK DRIVE 

4TH WORD OF .MOSTA TAPE STATUS 

OFF LINE 

MAINTENANCE MODE ENABLED 

MAINTENANCE MODE REQUESTED 

BOT 

REWINDING 

WRITE LOCKED 



.MODVT==:5 



; 5TH WORD OF .MOSTA DEVICE TYPE 



DEFINITIONS FOR THIS ARE SAME AS USED IN . MTALN 
MOOFL= 
MOPST= 



40 
42 



MORVS = = 
MORVL== 
MOVLS== 
MONTR== 



MORDL== 



MOWUL== 



MORLI=: 



;PSI FOR MAGTAPES 
;PSI FOR EOT ON MT ' S 
3/ PSI ASSIGNMENT (-1 => CLEAR) 

REWIND VOLUME SET 

REWIND CURRENT VOLUME 

VOLUME SWITCH FOR UNLABELED TAPES 

SET/CLEAR NO TRANSLATE FLAG 



. MOREW 

43 

44 

45 

3/ -1 => DON'T CONVERT EBCDIC TO ASCII 

3/0=> CONVERT 

46 ;READ USER LABELS 
2/ GETS LABEL I.D. 

3/ SP TO WHERE 76 CHARCTERS ARE TO BE PLACED 

47 ;WRITE USER LABELS 
2/ LABEL I.D. 

3/ SP TO 76 CHARACTERS OF DATA 



MOSMV== 



50 

MOMTP== 

MOMVN== 

MOMOW== 

MOMFM== 

MOMRL== 

MOMBL== 

MOMCD== 

MOMED== 

MOMFI== 

MOMGN== 

MOMGV== 

MOVMB== 

51 

TPFST== 

TPFCP== 

TPFFC== 

TPFNC== 



1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 



1 
2 
3 



READ LABEL INFORMATION FOR MT 

TYPE OF LABEL 

VOLUME NAME 

OWNER 

FORMAT OF TAPE FILE 

RECORD LENGTH 

BLOCK LENGTH 

CREATION DATE 

EXPIRATION DATE 

FILE NAME 

GENERATION NUMBER 

GENERATION VERSION NUMBER 

VALUE OF MODE BYTE 

SET MODE VALUE 

STREAM MODE 

ALL FORMATTING CONTROLS PRESENT 

FORTRAN CONTROLS PRESENT 

NO CONTROLS PRESENT 
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.TPFMX== 


3 


MOSDS==:52 




MOPSI==:27 




MO%MSG==:1BO 




MOSID==:27 




MOIEL==:30 




MOSHV==:45 




.MOFMT== 


1 


.MOEPD== 


2 


.MOBSZ== 


3 


.MORSZ== 


4 



MAX VALUE OF FIELD 

SET DEFERRED VOLUME-SWITCH MODE 

SET ERROR PS I FOR LPT AND CDR 

SUPPRESS STANDARD CTY MESSAGES 

SET REEL I.D. 

INHIBIT ERROR LOGGING 

SET HDR1 AND HDR2 VALUES FOR MT 

OFFSET FOR FORMAT 

EXPIRATION DATE 

BLOCK SIZE 

RECORD SIZE 



;DEF FOR IPCF MESSAGE SENT ON A VOLUME SWITCH OR OTHER CONDITION 
;MESSAGE CODE IS . IPCTR. OFFSETS THAT FOLLOW ARE 
; RELATIVE TO WORD CONTAINING .IPCTR. 



VMCOD==:0 




.VMABT==- 


1 


.VMICN== 


2 


.VMERR== 


3 


.VMVSM== 


4 


.VMSTS== 


5 


.VMUNL== 


6 


.VMREW== 


7 


VSMTN==:1 




VSFLG==:2 




VS%FLG==:-1B17 




VS%WRT== 


:1B0 


VS%COD==:777777 




.VSMNV== 


:1 


.VSFST== 


:2 


.VSLST== 


.3 


.VSMRV== 


:4 


.VSFLS== 


•5 


VSCNT==:3 





CODE FOR THIS MESSAGE 

IS SUBCODE OF .IPCTR FUNCTION 
ABORT CLOSE 

INTERNAL ERROR (HOPEFULLY NOT USED) 
LABEL R/W ERROR 
VOLUME SWITCH 

UNIT STATUS CHANGE (NOT USED YET) 
UNIT UNLOAD 
REWIND 
MT NUMBER 
FLAGS 

FLAGS PART OF WORD 

WRITE PREVIOUS VOLUME WAS OPENED FOR WRITE 
CODE 

MOUNT NTH VOLUME 
MOUNT FIRST VOLUME 
MOUNT LAST VOLUME 

MOUNT RELATIVE VOLUME NUMBER (SIGNED) 
FORCE LABELED TAPE VOLUME-SWITCH 
VOLUME NUMBER (SIGNED IF VS%MRV IS ON) 
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MOLVF== 


32 




MORVF== 


33 


MOLTR== 


34 


MORTR== 


35 


MOSTS== 


36 


MORST== 


:37 


MO%LPC==l 


MO%LCI==2 


MO%LVF==4 


MO%LVU==20 


MO%RPE==40 


MO%RCK==:l 


MO%PCK== 


2 


MO%SCK== 


4 


MO%HEM== 


10 


MO%SFL== 


20 



LOAD DEVICE'S VFU 

READ VFU FILE NAME 

LOAD TRANSLATION RAM 

READ RAM FILE NAME 

SET SOFTWARE STATUS 

READ SOFTWARE STATUS 

PAGE COUNTER OVERFLOW 

CHARACTER INTERRUPT (HARD ERROR) 

VFU ERROR. PAPER MUST BE RE-ALIGNED 

LINE PRINTER HAS OPTICAL VFU 

RAM PARITY ERROR 

READ CHECK 
PICK CHECK 
STACK CHECK 
HOPPER EMPTY 
STACKER FULL 



M0%FNX==:1B17 

M0%0L==:1B16 

M0%HE==:1B15 



MO%SER== 
MO%IOP== 
MO%EOF== 

; 1B11 

MO%FER== 
MO%LCP== 
MO%RLD== 

.MOFLO==:40 



1B14 
1B13 
1B12 

1B10 

1B0 

1B1 



NON-EXISTENT DEVICE 

DEVICE IS OFF-LINE 

HARDWARE ERROR 

SOFTWARE ERROR 

I/O IN PROGRESS 

END OF FILE 

RESERVED 

FATAL ERROR 

LOWER CASE PRINTER 

FRONT-END WAS RELOADED 

FLUSH OUTPUT 



;SEE SETJB FOR VARIOUS ARGUMENT VALUES 



MOSNT==:34 
.MOSMN==:l 
.MOSMY==:0 

MORNT==:35 



SET TTY NON-TERMINAL STATUS 
NO SYSTEM MESSAGES (I.E. SUPPRESS) 
YES SYSTEM MESSAGES (DEFAULT) 
READ TTY NON-TERMINAL STATUS 



;PTY MTOPR NUMBERS 



.MOAPI==: 24 




MO%WFI== 


:1B0 


MO%OIR== 


:1B1 


MO%SIC== 


:77B17 


.MOPIH==:25 




.MONWI== 


:0 


.MOWFI== 


:-l 


.MOBAT==: 26 




.MOJCB==: 


1 


.MONCB==: 


D 



ASSIGN PTY INTERRUPT CHANNELS 

ENABLE WAITING FOR INPUT 

ENABLE OUTPUT IS WAITING 

SOFTWARE INTERRUPT CHANNEL 

TEST PTY INPUT HUNGRY 

NOT WAITING FOP INPUT 

WAITING FOR INPUT 

SET BATCH BIT 

JOB CONTROLLED BY BATCF 

JOB NOT CONTROLLED BY BATCH 
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;TTY MODE DEFINITIONS 



.MORLW== 
.MOSLW== 
.MORLL== 
.MOSLL== 
.MOSIG== 
.MORBM== 



30 
31 
32 
33 
36 
37 



READ WIDTH 

SET WIDTH 

READ LENGTH 

SET LENGTH 

SET "IGNORE INPUT WHEN INACTIVE" BIT 

READ 128 CHARACTER BREAK MASK 



MOSBM= 
MORFW= 
MOSFW= 
MOXOF= 



MORXO= 
MOSLC= 
MORLC= 
MOSLM= 
MORLM= 
MOTPS= 
MOPCS= 
MOPCR= 



MO%WNl== 
MO%WN2== 
MO%WN3=; 
MO%WN4== 

MO%WFl== 
MO%WF2== 
MO%WF3== 
MO%WF4== 

MO%WPl== 
MO%WP2== 
MO%WP3== 
MO%WP4== 

MO%WAl== 
MO%WA2== 
MO%WA3== 
MO%WA4 = = 

40 

41 

42 

43 

MOOFF=; 

MOONX=; 

44 

45 

46 

47 

50 

51 

52 

53 



776117, ,777740 





20 

001260, ,000420 





20 



BIT DEFINITIONS FOR NON-FORMATTING CONTROL 

FOR ASCII CODES 40-777 

FOR ASCII CODES 100-137 

FOR ASCII CODES 137-177 

FORMATTING CONTROL BITS 

FOR ASCII CODES 40-77 

FOR ASCII CODES 100-137 

FOR ASCII CODES 140-177 



000400,, 400 ;PUNCTUATION BIT DEFINITIONS 
777774, ,001760 ; FOR ASCII CODES 40-77 
400000, ,000760 ; FOR ASCII CODES 100-137 
400000, ,000760 ; FOR ASCII CODES 140-177 



400 

000003, ,776000 
377777, ,777000 
377777, ,777020 



;NET MTOPR NUMBERS 



.MOACP== 


20 




TOPS20AN 


. MOSND== 


21 




TOPS20AN 


.MOSIN== 


22 




TOPS2 0AN 


.MOAIN== 


24 




TOPS20AN 


MO%NIN== 


77B5 


TOPS 20 AN 


MO%FSP 


4==. 


77B17 


TOPS20AN 



ALPHANUMERICS DEFINITIONS 

FOR ASCII CODES 40-77 

FOR ASCII CODES 100-137 

FOR ASCII CODES 140-177 
SET 128 CHARACTER BREAK MASK 
READ FIELD WIDTH 
SET FIELD WIDTH 
SET/CLEAR XOFF/XON HANDLING 
TURN OFF XON/XOFF PROCESSING 
TURN ON XON/XOFF PROCESSING 
READ VALUE OF XOFF BIT 
SET LINE COUNTER 
READ LINE COUNTER 
SET LINE COUNTER MAXIMUM 
READ LINE COUNTER MAXIMUM 
PSI FOR NON-CONTROLLING TERMINAL 
SET PAGE PAUSE CHARACTER 
READ PAGE PAUSE CHARACTER 



ACCEPT CONNECTION ON SOCKET 

SEND ALL CURENTLY BUFFERED BYTES 

SEND INS/INR COMMAND 

ASSIGN INS/INR AND FSM PSI CHANNELS 

INS/INR SOFTWARE INTERRUPT CHANNEL 

FSM CHANGE OF STATE INTERRUPT CHANNEL 



DEFINITIONS FOR DECNET 



MOACN==:24 




MO%CDN== 


777B8 


MO%INA==- 


777B1" 


MO%DAV== 


777B26 


.MONCI= 


■-='.111 


.MOCIA= 


--=:116 



MORLS==:25 



ASSIGN CONNECT INTERRUPT CHANNEL 

CONNECT INTERRUPT CHANNEL 

INTERRUPT MESSAGE CHANNEL 

DATA AVAILABLE CHANNEL 

NO CHANGE 

CLEAR INTERRUPT ASSIGNMENT 

;READ LINK STATUS 
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MO%CON== 


1B0 


MO%SRV== 


IBl 


MO%WFC== 


1B2 


MO%WCC== 


1B3 


MO%EOM== 


1B4 


MO%ABT== 


1B5 


MO%SYN== 


1B6 


MO%INT== 


1B7 


MO%LWC== 


1B8 


MORHN== 


26 




MORTN== 


27 




MORUS== 


30 




MORPW== 


31 




MORAC== 


32 




MORDA== 


33 




MORCN== 


34 




MORIM== 


35 




MOSIM== 


36 




MOROD== 


37 




MOCLZ== 


40 




MOCC==:41 




MORSS== 


42 




MOANT== 


43 




MOSNH== 


44 




.SHTTY==:1 




.SHESC==: 2 




SH%LPM= 




LBO 



LINK IS CONNECTED 

LINK IS A SERVER 

WAITING FOR A CONNECT 

WAITING FOR THIS LINK TO CONFIRM 

EOM PRESENT IN INPUT BUFFER 

CONNECTION ABORTED 

SYNCH DI RECIEVED 

INT MESSAGE AVAILABLE 

LINK WAS CONNECTED 

READ HOST NAME 

READ TASK NAME 

READ USER DATA 

READ PASSWORD 

READ ACCOUNT 

READ OPTIONAL DATA 

READ CONNECT OBJECT NUMBER 

READ INTERRUPT MESSAGE 

SEND INTERRUPT MESSAGE 

READ OBJ-DESC OF CONNECTION 

CLOSE/REJECT A CONNECTION 

ACCEPT A CONNECTION 

READ SEGMENT SIZE 

ATTACH NETWORK TERMINAL 

SET NETWORK HOST 

ARG BLOCK - TTY IDENT 

- FLAGS, ,ESC CHAR 

FLAG - LOCAL PAGE MODE 



DEFINITIONS FOR ATS 

; FUNCTION CODES FOR MTOPR ARE IN COLUMN 1 



MOAMO= 


= :1 
.MOAMM==:l 
.MOADM==: 2 




MOAAT= 


= :2 

MO%AER==:1BO 




MOASI= 


= :3 

MO%IFL==:777B8 
.MOAAI==:0 
.MOADI==: 1 

MO%IEV==:777B17 
.MOADT==:0 
.MOAST==:l 






MO%ACH==:777777B35 


MORCD= 


= :4 

MO%WDV==:777B35 

.MOALD==:0 

.MOCHG==:l 

.MOLST==:2 

MO%ARM==:lB0 

MO%MDA==: IBl 






AT%OPN== 


1B0 




AT%TCL== 


IBl 




AT%DHT== 


1B2 




AT%TXF== 


1B3 




AT%UND== 


1B4 




AT%NAV== 


1B5 




AT%OFL== 


1B6 




AT%FUL== 


1B7 




AT%UNS== 


1B8 




AT%REJ== 


1B9 




AT%MIE== 


1B10 



SET MODE WORD 

MESSAGE MODE 

DATA MODE 

ACQUIRE TERMINAL 

HTN FIELD CONTAINS AN ERROR CODE 

ENABLE INTERRUPTS 

FUNCTION TO BE PERFORMED 

ASSIGN INTERRUPT CHANNEL 

DEASSIGN INTERRUPT CHANNEL 

EVENT BEING ASSIGNED OR DEASSIGNED 

DATA ARRIVAL 

STATUS ARRIVAL 

CHANNEL NUMBER 

GET STATUS 

WHICH DEVICES TO REPORT ON 

ALL TERMINALS 

TERMINALS WHOSE STATUS HAS CHANGED 

TERMINALS SPECIFIED IN LIST 

ASK THE RESOURCE MANAGER 

MORE DATA AVAILABLE FOR THIS J FN 

HTN IS OPEN AND USABLE 

NRM CLOSED TERMINAL VIA STATUS-REPORT 

DEASSIGNING HTN 

TERMINAL IS XOFF'D 

DEVICE REQUESTED IS UNDEFINED 

DEVICE REQUESTED IS NOT AVAILABLE 

DEVICE REQUESTED IS OFFLINE 

SERVER IS FULL 

DEVICE TYPE IS UNSUPPORTED 

NODE NRM REJECTED THE REQUEST 

MONITOR INTERNAL ERROR (NODE OR HOST) 
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AT%STF== 
AT%CRJ== 
AT%NDP== 
AT%SER== 
MOADE==:5 

MO%AAB==:1BO 



1B.11 ;VT6 2 START-UP FAILED 
1B12 ; CONNECTION WAS REJECTED 
1B.13 ;DATA PIPE IS NOT OPEN 
777777B35 ;STATUS REPORT ERROR CODE 
;DEASSIGN TERMINAL 
; DON'T SEND REMAINING DATA 



(18 BITS) 



; FUNCTION CODES FOR AYDIN DISPLAY MTOPR 



.MOFLE==:0 

.MORER==:l 

.MOWAT==: 2 

MO%RWC==:777777B17 
MO%LER==:777777B35 



FLUSH ERRORS 
RETURN AYDIN ERROR CODE 
WAIT FOR ACTIVITY TO STOP 
REMAINING WORD COUNT 
LAST AYDIN ERROR CODE 
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;DEFS FOR MTU JSYS 
; FUNCTIONS: 



.MTNVV== 


:1 








. MTCNT== 









. MTCOD== 


1 






. MTPTR== 


2 




.MTRAL== 


:2 








. MTVL1== 


1 






. MTVL2== 


2 






. MTHD1== 


3 






. MTHD2== 


4 




•MTASI== 


:3 








. MTPHU== 


1 








MTNUL==: 


-l ; 


.MTCVV== 


:4 







SET NO VOLUME VALID 

COUNT WORD 

ERROR CODE 

SP TO OPERATOR RESPONSE 

READ ALL LABELS 

SP TO VOL1 AREA 

SP TO VOL2 AREA 

SP TO HDR1 AREA 

SP TO HDR2 AREA 

RETURN MT TO MTA ASSOCIATION 

RETURN MTA UNIT NUMBER HERE 

NO ASSIGNMENT CODE 

CLEAR VV 
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MONSYM 



MUENB== 


1 


MUDIS== 


2 


MUGTI== 


3 


MUCPI== 


4 


MUDES== 


5 


MUCRE== 


6 


MUSSQ== 


7 


MUCHO==. 


10 


MUFOJ== 


11 


MUFJP== 


12 


MUFSQ== 


13 


MUFFP== 


15 


MUSPQ== 


16 


MUFPQ== 


17 


MUQRY== 


20 


MUAPF== 


.21 


MUPIC== 


22 


MUDFI== 


:23 


MUSSP== 


:24 


MURSP== 


:25 


MUMPS== 


:26 


MUSKP== 


:27 


MURKP== 


30 


MUSPS== 


:31 



ENABLE PID FOR RECEIVING 

DISABLE PID FROM RECEIVING 

GET PID OF [SYSTEM] INFO 

CREATE A PRIVATE INFO FOR A JOB 

DESTROY A PID 

CREATE A PID 

SET SEND AND RECEIVE QUOTAS 

CHANGE OWNER OF A PID 

FIND OWNER'S JOB NUMBER 

FIND JOB'S PIDS 

FIND SEND AND RECEIVE QUOTAS 

FIND FORK'S PIDS 

SET PID QUOTA 

FIND PID QUOTA 

QUERY 

ASSOCIATE A PID WITH A FORK 

PUT PID ON AN INTERRUPT CHANNEL 

DEFINE PID OF [SYSTEM] INFO 

SET SYSTEM PID TABLE 

READ SYSTEM PID TABLE 

GET MAXIMUM PACKET SIZE 

SET PID TO RECEIVE KILLED PID MESSAGE 

READ PID THAT RECEIVES KILLED PID MESSAGES 

Get system maximum packet size 



; SYSTEM PID TABLE INDEX VALUES 



.SPIPC== 
.SPINF== 
.SPQSR== 
.SPMDA== 
.SPOPR== 
.SPNSR== 



PID OF IPCC 

PID OF INFO 

PID OF QUASAR 

PID OF QSRMDA 

PID OF OPERATOR JOB (ORION) 

PID OF NETSER 



;NODE 



.NDSLN==:0 

.NDGLN==:1 

.NDNOD==:0 

.NDSNM==:2 

.NDMAX==:377 

.NDGNM==: 3 

.NDSLP==:4 

.NDPRT==:0 

.NDCLP==:5 

.NDFLP==:6 

ND%LPR==1B0 
ND%LPA==1B1 

.NDSNT==:7 

.NDNNO==:0 
.NDMSK==:1 

.NDGNT==:10 

.NDNND==:0 
.NDCNT==:1 
.NDBK1==2 



SET LOCAL NODE NAME 

GET LOCAL NODE NAME 

POINTER TO NODE NAME 

SET LOCAL NODE NUMBER 

MAXIMUM NODE NUMBER 

GET LOCAL NODE NUMBER 

SET LOOPBACK ON PORT 

PORT TO SET IN LOOPBACK 

CLEAR LOOPBACK ON PORT 

FIND LOOPBACK PORT 

LOOPBACK RUNNING 

LOOPBACK ASSIGNED TO PORT 

SET NETWORK TOPOLOGY INFORMATION 

NUMBER OF NODES REPRESENTED IN BIT MASK 

FIRST WORD OF REACHABLE NODES BIT MASK 

GET NETWORK TOPOLOGY INFORMATION 

NUMBER OF NODE BLOCK POINTERS FOLLOWING 

NUMBER OF WORDS IN A NODE BLOCK 

FIRST ADDRESS OF A NODE BLOCK 



;NODE BLOCK DEFINITIONS 

.NDNAM==:0 

.NDSTA==:1 



; POINTER TO ASCIZ NODE NAME 
;NODE STATE 
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.NDSON== 


:0 ; 




, .NDSOF==:l ; 




.NDNXT==:2 




.NDNBS==:3 ; 


.NDSIC== 


:11 




.NDCHN==:0 


•NDCIC== 


:12 


.NDGVR== 


:13 




.NDNVR==:0 




.NDCVR==:1 ; 




.NDRVR==:2 




.NDVER==:0 




.NDECO==:l ; 




,ND.CST==:2 


.NDGLI== 


:14 




.NDNLN==:0 ; 




.NDCNT==:1 ; 




; LINE BLOCK DEFINITION 




.NDLNM==:0 ; 




.NDLST==:1 ; 




.NDLON== 


1 




.NDLOF== 


2 




.NDLCN== 


3 




•NDLCB== 


4 ; 




.NDLND==:2 ; 




.NDLSZ==:3 ; 


•NDVFY== 


:15 




.NDFLG==:1 




ND%EXM==:1B0 


•NDRNM== 


:16 





ON 

OFF 

POINTER TO ASCIZ NEARER NEIGHBOR STRING 

NODE BLOCK SIZE 

SET TOPOLOGY CHANGE INTERRUPT CHANNEL 

CHANNEL NUMBER 

CLEAR NETWORK TOPOLOGY INTERRUPT 

GET NSP VERSION INFORMATION 

NUMBER OF VERSIONS RETURNED 

POINTER TO COMMUNICATONS VERSION BLOCK 

POINTER TO ROUTING VERSION BLOCK 

VERSION NUMBER 

ECO NUMBER 

CUSTOMER LEVEL 

GET LINE INFORMATION 

<# OF ENTRIES FOLLOWINO , , <# LINE RETURNED> 

NUMBER OF WORDS IN A LINE BLOCK 



NSP PORT (LINE) NUMBER 

STATE OF LINE 

ON 

OFF 

CONTROLLER LOOPBACK 

CABLE LOOPBACK 

BYTE POINTER NODE AT END OF LINE 

SIZE OF BLOCK 

VERIFY NODE NAME 

FLAGS RETURNED BY MONITOR 

NODE SPECFIED EXACTLY MATCHES A KNOWN NODE 

GIVEN A NODE NUMBER, RETURN THE NODE NAME 



; NOUT 



NO%MAG= 
NO%SGN= 
NO%LFL= 
NO%ZRO= 
NO%OOV= 
NO%AST= 
NO%COL= 
NO%RDX= 



1B0 

1B1 

1B2 

1B3 

1B4 

1B5 

177B17 

777777 



OUTPUT MAGNITUDE 

OUTPUT SIGN 

LEADING FILLER 

FILL WITH ZERO'S 

OUTPUT ON COLUMN OVERFLOW 

OUTPUT ASTERISKS ON OVERFLOW 

NUMBER OF COLUMNS TO USE 

RADIX 



;NTMAN% ARGUMENT BLOCK 



NTCNT==:0 




NTENT==:1 




.NTNOD== 





•NTLIN== 


1 


•NTLOG== 


2 


.NTCKT== 


3 


.NTMOD== 


4 


NTEID==:2 




NTFNC==: 3 




LOWFNC== 


-2 


.NTMAP== 


-2 


•NTREX== 


-1 


.NTSET== 





.NTCLR== 


1 


.NTZRO== 


2 



;NUMBER OF WORDS IN ARGUMENT BLOCK 
; ENTITY 

NODE 

LINE 

LOGGING 

CIRCUIT 

MODULE 

;BYTE POINTER TO ENTITY ID 
; FUNCTION 

VALUE OF FIRST FUNCTION VALUE 

MAP NODE NUMBER/NODE NAME 

RETURN EXECUTOR NODE ID 

SET PARAMETER 

CLEAR PARAMETER 

ZERO ALL COUNTERS 
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.NTSHO== 
.NTSZC== 
.NTRET== 
,NTSEL==:4 



SHOW SELECTED ITEMS 
SHOW AND ZERO ALL COUNTERS 
RETURN LIST OF ITEMS 
; SELECTION CRITERION 



; SELECTORS FOR .NTSHO FUNCTION 



.NTSUM== 
.NTSTA== 
.NTCHA== 
.NTCOU== 
.NTEVT== 



SUMMARY 

STATUS 

CHARACTERISTICS 

COUNTERS 

EVENT 



; SELECTORS FOR .NTRET FUNCTION 



.NTKNO== 


-1 


.NTACT== 


-2 


.NTLOP== 


-3 


NTQUA==:5 




NTBPT==:6 




NTBYT==:7 




NTERR==:10 





KNOWN ITEMS 
ACTIVE ITEMS 
LOOP 



BYTE POINTER TO FUNCTION QUALIFIER 
BYTE POINTER TO PARAMETER OR LIST DATA 
NUMBER OF BYTES IN RETURNED DATA 
ERROR RETURN STATUS 



;MISCELLANEOUS NTMAN% SYMBOLS 



.NTARG== 


11 


•NDALN== 


2 


.NDPLN== 


2 


.NDAMX== 


~D255 


.NDNMX== 


7 



LENGTH OF NTMAN% ARGUMENT BLOCK 
NUMBER OF BYTES IN A NODE ADDRESS 
NUMBER OF BYTES IN A PARAMETER NUMBER 
MAXIMUM NODE ADDRESS 
MAXIMUM NUMBER OF BYTES IN A NODE NAME 
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0F%FDT==:1B33 

;OIiCNV — SEE IDCNV FOR BITS 



; FORCE DATE UPDATE 



;ODTIM 

OT%NDA= 
OT%DAY= 
OT%FDY= 
OT%NMN= 
OT%FMN= 
OT%4YR= 
OT%DAM= 
OT%SPA= 
OT%SLA= 
OT%NTM= 
OT%NSC= 
OT%12H= 
OT%NCO= 
OT%TMZ= 
OT%SCL= 



1B0 

1B1 

1B2 

1B3 

1B4 

1B5 

1B6 

1B7 

1B8 

1B9 

1B10 

1B11 

1B12 

1B13 

1B17 



DO NOT OUTPUT DATE 
OUTPUT DAY OF WEEK 
OUTPUT NUMERIC MONTH 
OUTPUT NUMERIC MONTH 
OUTPUT MONTH IN FULL 
OUTPUT 4-DIGIT YEAR 
OUTPUT DAY AFTER MONTH 
OUTPUT SPACES IN DATE 
OUTPUT SLASHES IN DATE 
DO NOT OUTPUT TIME 
DO NOT OUTPUT SECONDS 
OUTPUT 12-HOUR FORMAT 
DO NOT OUTPUT COLON 
OUTPUT TIME ZONE 
SUPPRESS COLUMNIZATION 



;ODTNC — SEE IDCNV FOR BITS 



;OPENF 



OF%BSZ== 


77B5 


OF%MOD== 


17B9 


OF%HER== 


1B18 


OF%RD==: ] 


LB19 


OF%WR==:] 


LB20 


OF%EX==:] 


LB21 


OF%APP== 


1B22 


OF%RDU== 


1B23 


OF%THW== 


1B25 


OF%AWT== 


1B26 


OF%PDT== 


1B27 


OF%NWT== 


1B28 


OF%RTD== 


1B29 


OF%PLN== 


1B30 


OF%DUD== 


1B31 


OF%OFL== 


■1B32 


OF%FDT== 


1B33 


OF%RAR== 


:1B34 



BYTE SIZE 

MODE 

HALT ON 10 ERROR 

READ 

WRITE 

EXECUTE (RESERVED FOR THE FUTURE) 

APPEND 

READ UNRESTRICTED 

THAWED 

ALWAYS WAIT 

PRESERVE DATES 

NEVER WAIT 

RESTRICTED 

SET TO DISABLE LINE NUMBER CHECKING FOR 

NON-LINE NUMBER FILES 
DON'T UPDATE TO DISK BY DDMP 
ALLOW OPENING THE DEVICE EVEN IF OFFLINE 
FORCE DATE UPDATE 

Wait if file is off-line 
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;PDVOP MANIPULATES PROGRAM DATA VECTORS 
; FUNCTION CODES ACCEPTED IN AC1 : 



POGET== 
POADD== 
POREM== 
PONAM== 
POVER== 
POLOC== 



GET A SET OF PDVAS (PROGRAM DATA VECTOR ADDRESS 

ADD A SET OF PDVAS 

REMOVE A SET 

GET NAME OF A PROGRAM 

GET VERSION NUMBER OF A PROGRAM 

LOCATE PDVS HAVING SPECIFIED NAME 



;ARG BLOCK OFFSETS FOR BLOCK ADDRESSED BY AC2 



POCT1==:0 



.POPHD== 
.POCT2== 
.PODAT== 
.POADR== 
•POADE== 



SIZE OF ARG BLOCK INCLUDING THIS WORD 

PROCESS HANDLE 

SIZE OF DATA BLOCK (AND SIZE OF RETURNED DATA; 

ADDRESS OF DATA BLOCK 

SMALL ADDRESS OF DATA VECTOR 

LARGE ADDRESS OF DATA VECTOR ADDRESS RANGE 



;OFFSETS DEFINED WITHIN PROGRAM DATA VECTORS 



PVCNT=: 

PVNAM= = 
PVSTR== 
PVREE== 
PVVER= = 
PVMEM== 
PVSYM== 
PVCTM== 
PVCVR== 
PVLTM== 
PVLVR=: 
PVMON== 
PVPRG== 
PVCST= = 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 



;PMAP BIT DEFINITIONS 



PM%CNT== 


:1B0 


PM%MVP==:1B1 


PM%RD==:1B2 


PM%WT==: 


1B3 


PM%WR==: 


1B3 


PM%EX==: 


1B4 


PM%RWX== 


:7B4 


PM%PLD== 


:1B5 


PM%IND== 


:1B6 


PM%TPU== 


:1B8 


PM%CPY==:1B9 


PM%EPN== 


:1B10 


PM%ABT== 


:1B11 


PM%RPT== 


:777777B35 



Length of vector 

Address of a word-aligned ASCIZ program name 

Program starting address 

Program reenter address 

Program version number 

Address of a block describing program memory 

Address of the program symbol table 

Time of program compilation 

Version number of compiler 

Time of program loading 

Version number of LINK 

Address of a monitor data block 

Address of a program data block 

Address of a customer-defined block 



RH WORD CONTAINS A COUNT 

MOVE PAGE INSTEAD OF INDIRECT POINTER 

(NOT IMPLEMENTED 
READ 
WRITE 

(ANOTHER NAME FOR ABOVE) 
EXECUTE (RESERVED FOR THE FUTURE) 
CONVENIENT ABBREV FOR RD+WT+EX 
PRELOAD PAGES BEING MAPPED 

USE INDIRECT PTRS (RESERVED FOR THE FUTURE) 
TRAP TO USER 

(NOT IMPLEMENTED — OBSOLETE) 
COPY ON WRITE 

EXTENDED PAGE NUMBER (18 BITS) 
ABORT UNMAP. 
REPEAT COUNT 



PMCTL - PHYSICAL MEMORY CONTROL 

MCPCE==:0 
MCSCE==:1 
.MCCST==:0 
MC%CEN==:1 



READ CACHE ENABLE 

SET CACHE ENABLE 

ARGLIST OFFSET FOR CACHE STATE 

CACHE ENABLED 
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.MCRPS==:2 


.MCSPS==:3 


•MCPPN== 





.MCPST== 


1 


•MCPSA== 





.MCPSS== 


1 


.MCPSO== 


2 


.MCPSE== 


3 


.MCRME==:4 


.PMMER== 


1 


.PMMTP== 





.PMMRG== 


1 


.PMMSY== 


2 


.PMMBN== 


:3 


•PMMSB== 


:4 


.PMMEA== 


5 


.PMMSN== 


:6 


.PMMNS== 


= :4 



READ PAGE STATUS 

SET PAGE STATUS 

ARGLIST OFFSET FOR PHYSICAL PAGE NUMBER 

ARGLIST OFFSET FOR PAGE STATE 

PAGE AVAILABLE 

PAGE IN TRANSITION STATE 

PAGE OFFLINE 

PAGE OFFLINE DUE TO ERROR 

READ MEMORY ERROR INFORMATION 

MOS MEMORY ERROR 

ENTRY HEADER AND TYPE 

ERROR REGISTER 

SYNDROME 

BLOCK NUMBER 

SPARE BIT NUMBER 

ERROR ADDRESS 

START OF SERIAL NUMBERS 

# OF SERIAL NUMBERS TO STORE 



;PRARG - PROCESS ARGUMENTS 
; FUNCTION CODE DEFINITIONS 



.PRARD==:1 
.PRAST==:2 



;READ ARGUMENT BLOCK 
;SET ARGUMENT BLOCK 
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;RCUSR AND RCDIR 

; FLAGS SUPPLIED ON CALL 



RC%PAR= = 
RC%STP== 
RC%AWL== 
RC%EMO== 



1B14 
1B15 
1B16 
1B17 



PARTIAL RECOGNITION IS ALLOWED 
STEP WILDCARD (PCDIR ONLY) 
ALLOW WILDCARDS (RCDIR ONLY) 
EXACT MATCH ONLY 



FLAGS RETURNED 



RC%DIR==1B0 
RC%ANA==1B1 
RC%RLM==1B2 



RC%NOM== 
RC%AMB== 
RC%NMD== 
RC%WLD== 



1B3 
1B4 
1B5 
1B6 



FILES-ONLY DIRECTORY 

ALPHANUMERIC ACCOUNTS ALLOWED 

REPEAT LOGIN MESSAGE 

NO MATCH FOUND 

AMBIGUOUS 

NO MORE DIRS - RETURNED IF STP IS REQUESTED 

WILDCARD DIR WAS INPUT 



;RCVOK 



.RCFCJ== 





.RCUNO==- 


1 


.RCCDR== 


.2 


.RCRQN== 


:3 


.RCNUA== 


4 


.RCARA== 


.5 


.RCCAP== 


.6 


.RCTER== 


7 


.RCRJB== 


10 



;RDTTY AND TEXTI 



RD%BRK== 


1B0 


RD%TOP== 


1B1 


RD%PUN== 


1B2 


RD%BEL== 


1B3 


RD%CRF== 


1B4 


RD%RND== 


1B5 


RD%JFN== 


1B6 


RD%RIE== 


1B7 


RD%BBG== 


1B8 


RD%BEG== 


1B9 


RD%RAI== 


:1B10 


RD%SUI== 


1B11 


RD%BTM== 


1B12 


RD%BFE== 


1B13 


RD%BLR== 


1B14 



; TEXTI ARG BLOCK 



RDCWB==- 





RDFLG== 


1 


RDIOJ== 


2 


RDDBP== 


3 


RDDBC== 


4 


RDBFP== 


.5 


RDRTY-= 


■6 


RDBRK== 


7 


RDBKL== 


10 



FUNCTION CODE,, JOB NUMBER 
USER NUMBER 
CONNECTED DIRECTORY 
REQUEST NUMBER 
NUMBER OF USER ARGS 
POINTER TO USER ARGS 
CURRENT CAPABILITIES 
TERMINAL NUMBER 
REQUESTED JOB 



BREAK ON REGULAR BREAK SET 

BREAK ON TOPS10 BREAK SET 

BREAK ON PUNCTUATION 

BREAK ON END OF LINE 

SUPPRESS CR (RETURNS LF ONLY) 

RETURN IF NOTHING TO DELETE 

JFNS GIVEN FOR SOURCE 

RETURN ON INPUT (BUFFER) EMPTY 

BEGINNING OF (DEST) BUFFER GIVEN 

RETURN IMMEDIATELY WHEN TYPIST EDITS TO .RDBKL 

RAISE LOWERCASE INPUT 

SUPPRESS ~U INDICATION 

BREAK CHARACTER TERMINATED INPUT 

RETURNED BECAUSE BUFFER EMPTY 

BACKUP LIMIT REACHED 



COUNT OF WORDS IN BLOCK 

FLAGS 

10 JFNS 

DEST BYTE POINTER 

DEST BYTE COUNT 

TOP OF BUFFER POINTER 

RETYPE (~R) POINTER 

BREAK SET MASK POINTER 

BACKUP LIMIT POINTER 
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;RFSTS 

RF%LNG==:1B0 
RF%PRH==:777777B35 

;RFSTS ARG BLOCK 

.KFCNT==:0 



.RFPSW== 
.RFPFL== 
.RFPPC== 
.RFSFL== 



RF%EXO==1BO 



;LONG FORM OF RFSTS CALL, ARG BLOCK IN 2 
; PROCESS HANDLE 



XWD COUNT OF WORDS RETURNED, 

MAXIMUM WORDS TO RETURN 
PROCESS STATUS WORD 
PROCESS' PC FLAGS 
PROCESS' PC 

STATUS FLAGS FOR PROCESS: 
PROCESS IS EXECUTE-ONLY 



; PROCESS STATUS WORD 



RF%FRZ==:1B0 


RF%STS==:377777B17 


.RFRUN==:0 


.RFIO==:l 


.RFHLT== 


2 


.RFFPT== 


3 


.RFWAT== 


4 


.RFSLP== 


5 


.RFTRP== 


6 


.RFABK== 


7 



RF%SIC==:777777B35 



PROCESS IS FROZEN 

PROCESS STATUS CODE 

RUNNABLE 

DISMISSED FOR I/O 

HALTED 

FORCED PROCESS TERMINATION 

WAITING FOR INFERIOR PROCESS 

SLEEP 

JSYS TRAPPED 

ADDRESS BREAK FREEZE 

SOFTWARE INTERRUPT CHAMNNEL 



;RFTAD/SFTAD 



.RSWRT== 
•RSCRV== 
.RSREF== 
.RSCRE== 
•RSTDT== 
.RSNET== 
.RSFET== 



WRITE DATE WORD 

CREATION DATE WORD 

REFERENCE DATE WORD 

INTERNAL SYSTEM WRITE DATE WORD 
Tape write date word 

Online expiration date/interval word 
Offline expiration date/interval word 



;RMAP 

RM%RD==1B2 

RM%WR==:1B3 

RM%EX==:1B4 

RM%PEX==:1B5 

RM%CPY==:1B9 

;RSMAP/SMAP 



READ ACCESS ALLOWED 
WRITE ACCESS ALLOWED 
EXECUTE ACCESS ALLOWED 
PAGE EXISTS 
COPY ON WRITE 



SM%RD== 
SM%WR== 
SM%EX== 



1B2 
1B3 
1B4 



SM%IND==:1B6 



READ ACCESS ALLOWED 
WRITE ACCESS ALLOWED 
EXECUTE ACCESS ALLOWED 
INDIRECT POINTER 



;RPACS/SPACS BIT DEFINITIONS 



PA%RD== 
PA%WT== 
PA%WR== 
PA%EX== 



1B2 
1B3 
1B3 
1B4 



READ ACCESS ALLOWED 
WRITE ACCESS ALLOWED 

(ANOTHER NAME FOR ABOVE) 
EXECUTE ACCESS ALLOWED 
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PA%PEX== 
PA%IND== 
PA%TPU== 



1B5 
1B6 
1B8 



PA%CPY==:1B9 
PA%PRV==:1B10 



P1%RD== 


•1B20 


P1%WR== 


1B21 


Pl%WT== 


1B21 


P1%EX==« 


1B22 


P1%PEX== 


=:1B23 


P1%CPY== 


=:1B27 



(RESERVED FOR THE FUTURE) 
PAGE EXISTS 
INDIRECT POINTER 
TRAP TO USER 

(NOT IMPLEMENTED — OBSOLETE) 
COPY ON WRITE 
PRIVATE 

READ ACCESS ALLOWED IN 1ST POINTER 
WRITE ACCESS ALLOWED IN 1ST POINTER 

(ANOTHER NAME FOR ABOVE) 
EXECUTE ACCESS ALLOWED IN 1ST POINTER 

(RESERVED FOR THE FUTURE) 
PAGE EXISTS IN 1ST POINTER 
COPY-ON-WRITE IN 1ST POINTER 
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; RSCAN 

.RSINI== 
.RSCNT== 



MAKE RESCAN BUFFER AVAILABLE FOR INPUT 
COUNT CHARACTERS LEFT TO READ FROM 
RESCAN BUFFER 



;RTIW 

RT%DIM== 
RT%PRH== 



1B0 

777777 



; DEFERRED TERMINAL INTERRUPT MASK GIVEN 
; PROCESS HANDLE 



;SCTTY 

.SCRET== 
.SCSET== 
.SCRST== 

;SCVEC 

.SVEAD== 

.SVINE== 

,SVGET== 

.SV40==:3 

.SVRPC== 

.SVMAK== 

.SVCST== 



RETURN DESIGNATOR (CTTY) FOR FORK 

SET SCTTY FOR FORK 

CLEAR FORK CTTY (RESTORE JOB CTTY) 



ENTRY ADDRESS 

INITIAL ENTRY FOR SETUP 

ENTRY ADDRESS FOR GET SHARE FILE ROUTINE 

ADDRESS TO GET LOCATION 4 

ADDRESS TO GET RETURN PC 

ENTRY FOR MAKE SHARE FILE ROUTINE 

2 WORD BLOCK FOR CONTROL-C/START PROCESSING 



;SDVEC 

.SDEAD== 
.SDINE== 
.SDVER== 
.SDDMS== 
.SDRPC== 



ENTRY ADDRESS 

INITIAL ENTRY 

DMS VERSION 

ADDRESS TO STORE DMS JSYS 

ADDRESS TO STORE RETURN PC 
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.SJDEN==:0 



.SJDDN== 
.SJDN2== 
.SJDN5== 
.SJDN8== 
.SJD16== 
.SJD62== 

.SJPAR==:1 
.SJPRO==:0 
.SJPRE==:1 

,SJDM==:2 
.SJDDM== 
.SJDMC== 
.SJDM6== 
.SJDMA== 
.SJDM8== 
.SJDMH== 



.SJRS==:3 
.SJDFS==:4 
.SJSPI==:0 
.SJSPD==:1 



.SJSRM== 

.SJT20== 

.SJDFR== 
.SJRFA==:0 
.SJRWA==:1 

.SJBAT==:10 

.SJLLO==:ll 



SET DEFAULT MAGTAPE DENSITY 

SYSTEM DEFAULT DENSITY 

200 BPI 

556 BPI 

800 BPI 

1600 BPI 

6250 BPI 

SET DEFAULT MAGTAPE PARITY 

ODD PARITY 

EVEN PARITY 

SET DEFAULT MAGTAPE DATA MODE 

SYSTEM DEFAULT DATA MODE 

CORE DUMP MODE 

SIX BIT BYTE MODE (FOR 7-TRACK DRIVES) 

ANSI ASCII MODE (7 BITS IN 8 BIT BYTE) 

INDUSTRY COMPATIBLE MODE 

HI-DENSITY MODE (9 EIGHT BIT 

BYTES IN 2 WORDS) 
SET DEFAULT MAGTAPE RECORD SIZE 
SET DEFERRED SPOOLING 
IMMEDIATE MODE SPOOLING 
DEFERRED MODE SPOOLING 
SET JOB SESSION REMARK 
DECLARE WHETHER TOPS20 COMMAND LEVEL OR NOT 

Set default job retrieval mode 

OPENF should" always fail 

OPENF should always request & wait 
SET BATCH FLAGS AND STREAM 
SEE .JIBCH FOR FIELD DEFINITIONS 
SET JOB LOCATION 



;SFORK 



SF%CON== 
SF%PRH= = 



:1B0 
:777777B35 



; CONTINUE PROCESS, IGNORE PC IN AC2 
; PROCESS HANDLE 



;SFUST 



.SFAUT==:0 
.SFLWR==:1 



;SET AUTHOR STRING 
;SET LAST WRITER STRING 
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;SMON FUNCTION CODES AND BIT DEFINITIONS (SYSTEM FLAGS) 



SFFAC== 

SFCDE== 

SFCDR== 

SFMST== 

SFRMT== 

,SFPTY = = 

SFCTY== 

, SFOPR= = 

, SFLCL= = 

, SFBTE = = 

SFCRD== 

,SFNVT== 

, SFWCT== 

, SFWLC = = 

SFWRM== 

SFWPT== 

SFWNV== 

,SFUSG== 

SFFLO= = 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 



; TOPS 20 AN 



; TOPS 2 AN 



ALLOW FACT ENTRIES 

CHECKDISK FOUND ERRORS 

CHECKDISK RUNNING 

MANUAL START IN PROGRESS 

REMOTE LOGINS ALLOWED 

PTY LOGINS ALLOWED 

CTY LOGIN ALLOWED 

OPERATOR IN ATTENDANCE 

LOCAL LOGINS ALLOWED 

BIT TABLE ERRORS FOUND ON STARTUP 

USER CAN CHANGE DIRECTORY CHARACTERISTICS 

NVT LOGIN ALLOWED 

WHEEL LOGIN ON CTY ALLOWED 

WHEEL LOGIN ON LOCAL TERMINALS ALLOWED 

WHEEL LOGIN ON REMOTE TERMINALS ALLOWED 

WHEEL LOGIN ON PTY ' S ALLOWED 

WHEEL LOGIN ON NVT ' S ALLOWED 

USAGE FILE IN USE 

FULL LATENCY OPTIMIZATION 

CAUTION: SETTING THIS REQUIRES THAT THE 
SYSTEM BE AT REVISION LEVEL 10, AND 
THAT RH20 BOARD M8 555 BE AT REVISION LEVEL E 
OTHERWISE, THE FILE-SYSTEM MAY BE DAMAGED. 



.SFMTA== 
.SFMS0== 
.SFMS1== 



23 
24 
25 



MAGTAPE ALLOCATION ENABLED 
SYSTEM MESSAGE LEVEL 
SYSTEM MESSAGE LEVEL 1 



; BELOW ARE FUNCTION CODES THAT DO NOT MAP DIRECTLY INTO BITS 



.SFNTN== 


44 




; TOPS 2 AN 


.SFNDU== 


45 




; TOPS 2 AN 


•SFNHI== 


46 




; TOPS 20 AN 


•SFTMZ== 


47 






•SFLHN== 


50 




; TOPS 20 AN 


.SFAVR== 


.51 






.SFSTS== 


52 






.SFSOK== 


53 






.SFMCY== 


54 






•SFRDU== 


55 






.SFACY== 


56 






•SFRTW== 


57 






•SFTDF== 


60 






MT%UUT= 


= = 1B0 




.SFWSP== 


61 






SF%FAC== 


1B< 


SFFAO 




SF%CDE== 


1B< 


SFCDE> 




SF%CDR== 


1B< 


SFCDR> 




SF%MST== 


1B< 


SFMST> 




SF%RMT== 


1B< 


SFRMT> 




SF%PTY== 


1B< 


SFPTY> 




SF%CTY== 


1B< 


SFCTY> 




SF%OPR== 


1B< 


SFOPR> 




SF%LCL== 


1B< 


SFLCL> 




SF%BTE== 


1B< 


SFBTE> 




SF%CRD== 


1B< 


SFCRD> 




SF%NVT== 


1B< 


SFNVT> 


; TOPS 2 AN 


SF%USG== 


1B< 


SFUSG> 




SF%FLO== 


1B< 


SFFLO> 





NETWORK ON/OFF CONTROL 

NET DOWN/UP REQUEST 

NET HOST TABLE INITIALIZE 

SET TIME ZONE THIS SYSTEM IS IN 

SET LOCAL HOST NUMBER OF THIS NET SITE 

ACCOUNT VALIDATION ON/OFF 

ENABLE/DISABLE STATUS REPORTING 

GETOK/GIVOK DEFAULT SETTING 

SET MAX ORDINARY OFFLINE EXP PERIOD 

READ DATE UPDATE FUNCTION 

SET MAX ARCHIVE EXP PERIOD 

SET [NO] RETRIEVAL WAITS NON-0 => NO WAIT 

TAPE MOUNT CONTROLS 

UNLOAD UNREADABLE TAPES 

WORKING SET PRELOADING 

FACT ENTRIES ALLOWED 

CHECKDISK FOUND ERRORS 

CHECKDISK RUNNING 

MANUAL START IN PROGRESS 

REMOTE LOGINS ALLOWED 

PTY LOGINS ALLOWED 

CTY LOGIN ALLOWED 

OPERATOR IN ATTENDANCE 

LOCAL LOGINS ALLOWED 

BIT TABLE ERRORS FOUND ON STARTUP 

USER CAN CHANGE DIRECTORY CHARACTERISTICS 

NVT LOGINS ALLOWED 

USAGE FILE IN USE 

FULL LATENCY OPTIMIZATION IN USE 

CAUTION: SETTING THIS REQUIRES THAT THE 
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SF%MTA== 
SF%MS0== 
SF%MS1== 



1B<.SFMTA> 
1B<.SFMS0> 
1B<.SFMS1> 



SYSTEM BE AT REVISION LEVEL 10, AND 

THAT RH20 BOARD M8555 BE AT REVISION LEVEL D 

OTHERWISE, THE FILE-SYSTEM MAY BE DAMAGED. 

MAGTAPE ALLOCATION ENABLED 

SYSTEM MESSAGE LEVEL 

SYSTEM MESSAGE LEVEL 1 



SF%EOK== 
SF%DOK=: 



1B0 
1B1 



; ENABLE ACCESS CHECKING 

;ALLOW ACCESS IF CHECKING DISABLED 



;SINM JSYS DEFINITIONS 



SI%TMG==:1B0 
SI%E0M==:1B1 



; TRUNCATE MESSAGE 
;END-OF-MESSAGE FOUND 



;SIR JSYS (NEW FORM) 



SI%VEP== 
SI%LEV== 
SI%ADR== 



7B17 
77B5 
7777, ,-1 



VERSION OF SIR IN Tl 

LEVEL FIELD IN CHNTAB 

ADDRESS OF INTERRUPT ROUTINE IN CHNTAB 



;SKED JSYS 

.SACNT==:0 



; ARGUMENT BLOCK OFFSET FOR COUNT 



; FUNCTION CODES 



SKRBC== 

SKSBC== 
SKRCS== 



SKSCS== 
SKICS== 

SKSCJ== 



SKRJP== 

SKBCR== 

SKBCS== 
SKBBG== 

SKDDC== 

SKRCV== 



SAKNB==:1 

2 

3 

SACLS== 

SASHR== 

SAUSE== 

SA1ML== 

SA5ML== 

SA15L== 

4 

5 

SACTL==:1 

6 

SAJOB==:l 

SAJCL==:2 

SAWA==:3 

7 

SAJSH==:3 

SAJUS==:4 

10 

SABCL==:1 

11 

12 

SADRG==:1 

13 

SADCL==:1 

14 



SK%ACT== 
SK%WDF== 
SK%STP== 
SK%DRG== 



1B0 
1B1 
1B2 
1B3 



READ BIAS CONTROL KNOB 

OFFSET FOR KNOB VALUE 

SET BIAS CONTROL KNOB 

READ SHARE OF A CLASS 

CLASS 

SHARE 

USE 

1 MINUTE LOAD AVERAGE 

5 MINUTE LOAD AVERAGE 

15 MINUTE LOAD 

SET SHARE OF A CLASS 

START OR STOP CLASS SCHEDULING 

WORD FOR CONTROL BITS 

SET CLASS OF A JOB 

JOB 

CLASS OF JOB 

WA ON/OFF SWITCH 

READ CLASS PARAMETERS FOR A JOB 

JOB'S SHARE ALLOTMENT 

JOB'S CURRENT USE 

READ CLASS SETTING FOR BATCH JOBS 

BATCH CLASS 

SET CLASS FOR BATCH JOBS 

RUN BATCH JOBS ON DREGS QUEUE 

WORD TO SPECIFY DREGS OR NOT 

SET SYSTEM CLASS DEFAULT 

DEFAULT CLASS WORD 

READ STATUS 

CLASS BY ACCOUNTS 

WITHHOLD WINDFALL 

CLASS SCHEDULER OFF 

BATCH JOBS ARE BEING RUN ON DREGS QUEUE 



;SJPRI, SPRIW - PRIORITY WORD 
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JP%RTG== 
JP%SYS== 
JP%MNQ== 
JP%MXQ== 



177B17 
1B18 
77B29 
77B35 



RUN TIME GUARANTEE PERCENTAGE 

SYSTEM FORK (PRIORITY ABOVE ALL CLASSES) 

MINIMUM QUEUE 

MAXIMUM QUEUE 
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; SNOOP JSYS DEFINITIONS 
; SNOOP FUNCTION CODES 



.SNPLC== 





.SNPLS== 


1 


.SNPDB== 


2 


.SNPIB== 


3 


•SNPRB== 


4 


.SNPUL== 


5 


.SNPSY== 


6 


.SNPAD== 


7 



;SOUTM JSYS DEFINITIONS 

SO%WMG==1BO 

; SPOOL JSYS FUNCTION CODES 



.SPLDI== 
.SPLSD== 
.SPLRD== 



LOCK CODE INTO MONITOR VIRT MEMORY 

LOCK DOWN THE SWAPPABLE MONITOR 

DEFINE A BREAK POINT 

INSERT THE BREAK POINTS 

REMOVE THE BREAK POINTS 

UNLOCK AND RELEASE ALL SNOOP RESOURCES 

LOOK UP A MONITOR SYMBOL 

LOOK UP ADDRESS IN SYMBOL TABLE 



;WRITE END-OF-MESSAGE 



DEFINE AN INPUT SPOOLING DEVICE 
SET DIRECTORY OF SPOOLED DEVICE 
READ DIRECTORY OF SPOOLED DEVICE 



; FLAGS IN SPOOL MESSAGE ON LOGOUT AND SPOOLED FILE CLOSE 



SP%BAT== 
SP%DFS== 
SP%ELO== 
SP%FLO== 
SP%OLO== 



1B0 
1B1 
1B2 
1B3 
1B4 



; SPOOL ARGUMENT BLOCK 



SPLDV== 
SPLNA== 
SPLDR== 
SPLGN = = 



JOB IS A BATCH JOB 

SPOOLING IS DEFERRED 

JOB EXECUTED LGOUT JSYS ITSELF 

JOB FORCED TO LOG OUT BY TRAP IN TOP FK 

OTHER JOB AIMED LGOUT AT THIS ONE 



DEVICE DESIGNATOR 
NAME STRING 
DIRECTORY NUMBER 
GENERATION NUMBER 



;SSAVE 

SS%NNP==777777B17 

SS%CPY==:1B18 

SS%UCA==:1B19 

SS%RD==:1B20 

SS%WR==:1B21 

SS%EXE==:1B22 

SS%EPN==:1B23 

SS%FPN==:1B2 7+3 7 733 5T 



NEGATIVE NUMBER OF PAGES 
ALLOW COPY-ON-WRITE 
USE CURRENT ACCESS 
ALLOW READ ACCESS 
ALLOW WRITE ACCESS 
ALLOW EXECUTE ACCESS 
TABLE ENTRY IS TWO WORDS 

(PAGE NUMBER IN SECOND WORD) 
FIRST PAGE NUMBER 



;STCMP 

SC%LSS== 
SC%SUB== 
SC%GTR== 



1B0 
1B1 
1B2 



Tl LESS THAN T2 
Tl SUBSTRING OF T2 
Tl GREATER THAN T2 
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;STDIR 



ST%DIR== 


:1B0 


ST%ANA== 


:1B1 


ST%RLM== 


:1B2 



FILES ONLY DIRECTORY 
ALPHANUMERIC ACCOUNTS 
REPEAT LOGIN MESSAGE 



;STIW 

ST%DIM== 
ST%PRH== 



1B0 
777777B35 



;SWTRP DEFINITIONS 



.SWART== 


:0 




.SWRAT== 


:1 




.SWLUT== 


:2 




.SWRLT== 


:3 






.ARPFL== 







. AROPC== 


1 




.AREFA== 


2 




. ARNPC== 


3 



;TBLUK 



TL%NOM== 


1B0 


TL%AMB== 


1B1 


TL%ABR== 


1B2 


TL%EXM== 


1B3 



;SET DEFERRED INTERRUPT MASK 
; PROCESS HANDLE 



SET ARITHMETIC TRAP 

READ ARITHMETIC TRAP 

SET LUUO ADDRESS 

READ LUUO ADDRESS 

OFFSET IN TRAP BLOCK FOR PC FLAGS 

OFFSET FOR OLD PC VALUE 

OFFSET FOR E 

OFFSET FOR NEW PC WORD 



NO MATCH 

AMBIGUOUS 

LEGAL ABBREVIATION 

EXACT MATCH 



;TFORK 

; FUNCTION CODES IN LH AC1 



TFSET== 





TFRAL== 


1 


TFRTP== 


2 


TFSPS== 


3 


TFRPS== 


4 


TFTST== 


5 


TFRES== 


6 


TFUUO== 


7 


TFSJU== 


8 


TFRUU== 


9 



;TIMER DEFINITIONS 



.TIMRT== 
.TIMEL== 
.TIMDT== 
.TIMDD== 
.TIMBF== 
,TIMAL== 



SET TRAPS AS SPEC'D BY BIT TABLE 

REMOVE ALL TRAPS SET BY THIS FORK 

REMOVE TRAPS SET BY THIS FORK 

SET JSYS TRAP PSI CHAN IN LH ( 2 ) 

READ JSYS TRAP PSI CHAN INTO LH(2) 

TEST IF SELF MONITORED 

REMOVE TRAPS FROM ALL INFERIORS, CLR PSI 

SET UUO TRAPS FOR FORK 

SET BOTH UUO AND JSYS TRAPS 

REMOVE UUO TRAPS 



SET TIME LIMIT 

SET ELAPSED TIME CLOCK 

SET DATE & TIME CLOCK 

DELETE AN EXPLICT DATE & TIME CLOCK 

DELETE ALL ENTIRES BEFORE D&T 

DELETE ALL (INCLUDES TIME LIMIT) 
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TL%CRO== 


1B0 


TL%COR== 


1B1 


TL%EOR== 


1B2 


TL%ERO== 


1B3 


TL%SAB== 


1B4 


TL%ABS== 


1B5 


TL%STA== 


1B6 


TL%AAD== 


1B7 


TL%OBJ== 


777777B35 



CLEAR REMOTE TO OBJECT LINK 
CLEAR OBJECT TO REMOTE LINK 
ESTABLISH OBJECT TO REMOTE LINK 
ESTABLISH REMOTE TO OBJECT LINK 
SET ACCEPT BIT FOR OBJECT 
ACCEPT BIT STATE 
SET OR CLEAR ADVICE 
ACCEPT ADVICE 
OBJECT DESIGNATOR 



;UFPGS 
UF%NOW==:1BO 



;NO WAIT ON UPDATE 



;UTEST FUNCTION CODES 



.UTSET==:0 
.UTCLR==:1 



; START TESTING 

;STOP TESTING AND RETURN RESULTS 



;UTEST ARGUMENT BLOCK 



.UTADR: 
.UTLEN= 
.UTMAP= 



STARTING ADDRESS OF CODE 
LENGTH OF CODE 
START OF BIT MAP 



; USAGE 



.USENT== 





.USCLS== 


1 


.USCKP== 


2 


.USLGI== 


3 


.USLGO== 


4 


.USSEN== 


:5 


.USCKI== 


•6 


.USENA== 


7 


.USCAS== 


10 


,USSAS== 


•11 


.USRAS== 


12 


US%DOW== 


=:177B6 


US%SSM== 


-•.111111 


;UTFRK 




UT%TRP== 


:1B0 



WRITE ENTRY 

CLOSE OUT CURRENT FILE 

PERFORM CHECKPOINT 

LOGIN 

LOGOUT 

SESSION END 

SET CHECKPOINT INTERVAL 

ENABLE ACCOUNT VALIDATION 

CHANGE ACCOUNTING SHIFT NOW 

SET AUTOMATIC ACCOUNTING SHIFT CHANGE TIMES 

READ AUTOMATIC ACCOUNTING SHIFT CHANGE TIMES 

TABLE ENTRY FORMAT FOR . USSAS/ . USRAS : 

DAY-OF-WEEK BITS 

TIME IN SECONDS SINCE MIDNIGHT 



;ITRAP (OR DO ERJMP/ERCAL) TRAPPED JSYS 
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;WILD FUNCTIONS 

.WLSTR==:0 
.WLJFN==:1 

;WILD FLAGS AND BITS 



; COMPARE TWO STRINGS 
; COMPARE TWO JFNS 



WL%LCD== 


1B0 


WL%NOM== 


1B0 


WL%ABR== 


1B1 


WL%DEV== 


1B1 


WL%DIR== 


1B2 


WL%NAM== 


1B3 


WL%EXT== 


1B4 


WL%GEN== 


1B5 



DON'T CONVERT LOWER CASE TO UPPER CASE 

STRINGS DID NOT MATCH 

NON-WILD STRING IS ABBREVIATION OF WILD STRINi 

DEVICE FIELD DID NOT MATCH 

DIRECTORY FIELD DID NOT MATCH 

NAME FIELD DID NOT MATCH 

FILE TYPE DID NOT MATCH 

GENERATION NUMBER DID NOT MATCH 



; ARGUMENT BLOCK OFFSETS FOR XSIR AND XRIR JSYS'S 



SICNT== 
SILVT== 
SICHT== 



LENGTH OF BLOCK 
ADDRESS OF LEVEL TABLE 
ADDRESS OF CHANNEL TABLE 



;SCHEDULER CONTROL FLAGS (JSYS NOT YET DEFINED) 



SK%CYT== 


1B18 


SK%IOC== 


1B19 


SK%HT1== 


1B20 


SK%HT2== 


1B21 


SK%HQR== 


1B22 


SK%CL1== 


1B23 


;SK%BQE== 


=:1B24 


SK%RSQ== 


1B25 


SK%RQ1== 


1B26 


SK%TTP== 


1B27 


SK%WCF== 


.1B28 


SK%TOP== 


1B29 


SK%RQM== 


1B30 



CYCLE TIME 

10 QUANTUM CHARGE 

LIMIT HOLD TIME 

NO HOLD TIME AFTER SKIPPED FORK 

HIGH QUEUE FORK HAVE PRIORITY UNDER LOAD 

CLASS SKED, USE NORMAL QUEUE PRIORITIES IF 1 

BALSET QUEUE ON ENTRY 

QUICK RESCHEDULE ON WAKSUPS 

REQUEUE TO QUEUE 1 

TTY PREFERENCE 

WAIT CREDIT PROPORTIONAL TO LOAD AV 

TTY OUTPUT PREFERENCE 

REQUEUE DEPENDS ON MEM DEMAND 
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*********************************************** 
GENERAL FIELD AND VALUE DEFINITIONS 
USED BY MANY JSYSES 
*********************************************** 



; GENERAL FORK HANDLES 



.FHSLF==:400000 

FH%EPN==:1B19 
.FHSUP==:<Z -1> 
.FHTOP==:<Z -2> 
.FHSAI==:<Z -3> 
.FHINF==:<Z -4> 
.FHJOB==:<Z -5> 



SELF 

EXTENDED PAGE NUMBER 

SUPERIOR 

TOP IN JOB 

SELF AND INFERIORS 

INFERIORS 

ALL IN JOB 



; FIELDS OF JFN MODE WORD 



TT%OSP== 


1B0 


TT%MFF== 


1B1 


TT%TAB== 


1B2 


TT%LCA== 


1B3 


TT%LEN== 


177B10 


TT%WID== 


177B17 


TT%WAK== 


17B23 


TT%WK0== 


1B18 


TT%IGN== 


1B19 


TT%WKF== 


1B20 


TT%WKN== 


1B21 


TT%WKP== 


1B22 


TT%WKA== 


1B23 


TT%ECO== 


1B24 


TT%ECM== 


1B25 


TT%ALK== 


1B26 


TT%AAD== 


1B27 


TT%DAM== 


3B29 


.TTBIN== 





.TTASC== 


1 


.TTATO== 


:2 


.TTATE== 


:3 


TT%UOC== 


1B30 


TT%LIC== 


1B31 


TT%DUM== 


3B33 


.TTFDX== 





.TT0DX== 


1 


.TTHDX== 


2 


.TTLDX== 


3 


TT%PGM== 


:1B34 


TT%CAR== 


1B35 



OUTPUT SUPPRESS 

MECHANICAL FORMFEED PRESENT 

MECHANICAL TAB PRESENT 

LOWER CASE CAPABILITIES PRESENT 

PAGE LENGTH 

PAGE WIDTH 

WAKEUP FIELD 

WAKEUP CLASS (UNUSED) 

IGNORE TT%WAK ON SFMOD 

WAKEUP ON FORMATING CONTROL CHARS 

WAKEUP ON NON-FORMATTING CONTROLS 

WAKEUP ON PUNCTUATION 

WAKEUP ON ALPHANUMERICS 

ECHOS ON 

ECHO MODE 

ALLOW LINKS 

ALLOW ADVICE (NOT IMPLEMENTED) 

DATA MODE 

BINARY 

ASCII 

ASCII AND TRANSLATE OUTPUT ONLY 

ASCII AND TRANSLATE ECHOS ONLY 

UPPER CASE OUTPUT CONTROL 

LOWER CASE INPUT CONTROL 

DUPLEX MODE 

FULL DUPLEX 

NOT USED, RESERVED 

HALF DUPLEX (CHARACTER) 

LINE HALF DUPLEX 

PAGE MODE 

CARRIER STATE 
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; DIRECTORY PROTECTION DEFINITIONS (3 6-BIT FIELDS: OWNER, GROUP, WORLD) 



DP%RD== 
DP%CN== 
DP%CF== 



40 
10 
4 



READING DIRECTORY IS ALLOWED 

CONNECT TO DIR, OR CHANGE PROT/ACCOUNT 

CREATING FILES IN DIR IS ALLOWED 



;FILE PROTECTION DEFINITIONS (3 6-BIT FIELDS: OWNER, GROUP, WORLD) 



FP%DIR==:2 
FP%APP==:4 



FP%EX== 
FP%WR== 
FP%RD== 



10 
20 
40 



DIRECTORY LISTING 

APPEND 

EXECUTE 

WRITE 

READ 



; INPUT AND OUTPUT IDENTIFIERS 



.PRIIN== 


100 


•PRIOU== 


101 


•NULIO== 


377777 


.CTTRM== 


777777 


.DVDES== 


600000 


.TTDES== 


400000 



PRIMARY INPUT 

PRIMARY OUTPUT 

NULL DESIGNATOR 

JOB'S CONTROLLING TERMINAL 

UNIVERSAL DEVICE CODE 

UNIVERSAL TERMINAL CODE 



; MAGTAPE DEVICE STATUS BITS 



MT%ILW=: 
MT%DVE== 
MT%DAE== 
MT%SER== 
MT%EOF=; 
MT%IRL== 
MT%BOT== 
MT%EOT== 
MT%EVP== 
MT%DEN== 
.MTLOD== 
.MTMED== 
.MTHID=: 
MT%CCT== 
MT%NSH== 



1B18 

1B19 

1B20 

1B21 

1B22 

1B23 

1B24 

1B25 

1B26 

3B28 

1 

2 

3 

7B31 

1B32 



ILLEGAL WRITE 

DEVICE ERROR 

DATA ERROR 

SUPPRESS ERROR RECOVERY PROCEDURES 

EOF (FILE MARK) 

INCORRECT RECORD LENGTH 

BEGINNING OF TAPE 

END OF TAPE 

EVEN PARITY 

DENSITY (0 IS 'NORMAL') 

LOW DENSITY (200 BPI) 

MEDIUM DENSITY (556 BPI) 

HIGH DENSITY (800 BPI) 

CHARACTER COUNTER 

DATA MODE OR DENSITY NOT SUPPORTED BY HARDWARE 



; DEVICE DATA MODES 



.DMASC== 
.DMIMG== 
.DMIMB== 
•DMBIN== 



1 

10 
13 
14 



ASCII 

IMAGE 

IMAGE BINARY 

BINARY 
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;DEFINED 


PS I CHANNELS 


RADIX 5+5 


.ICAOV==:6 


.ICFOV== 


7 


•ICPOV== 


9 


.ICEOF== 


10 


.ICDAE== 


11 


.ICQTA== 


12 


. ICTOD== 


14 


.ICILI== 


15 


.ICIRD== 


16 


.ICIWR== 


17 


. ICIEX== 


18 


.ICIFT== 


19 


.ICMSE== 


:20 


. ICTRU== 


21 


. ICNXP== 


22 



ARITHMETIC OVERFLOW 

FLOATING OVERFLOW 

PDL OVERFLOW 

END OF FILE 

DATA ERROR 

QUOTA/DISK EXCEEDED 

TIME OF DAY (NOT IMPLEMENTED) 

ILLEG INSTRUCTION 

ILLEGAL READ 

ILLEGAL WRITE 

ILLEGAL EXECUTE (NOT IMPLEMENTED) 

INFERIOR FORK TERMINATION 

MACHINE SIZE EXCEEDED 

TRAP TO USER (NOT IMPLEMENTED) 

NONEXISTENT PAGE REFERENCED 
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TT33==:0 


TT35==:1 


TT37==:2 


TTEXE== 


3 


TTDEF== 


~D8 


TTIDL== 


~D9 


TTV05== 


~D10 


TTV50== 


~D11 


TTL30== 


~D12 


TTG40== 


~D13 


TTL36== 


~D14 


TTV52== 


"D15 


TT100== 


"D16 


TTL38== 


~D17 


TT120== 


~D18 


TT125== 


~D35 


TTK10== 


~D36 



MODEL 3 3 

MODEL 35 

MODEL 37 

EXECUPORT 

DEFAULT 

IDEAL 

VT0 5 

VT50 

LA30 

GT40 

LA36 

VT5 2 

VT100 

LA3 8 

LA120 

VT12 5 

VK100 - GIGI 



; DEFINED TERMINAL CODES 



TICBK== 

TICCA== 

TICCB== 

,TICCC== 

TICCD== 

TICCE== 

TICCF== 

TICCG== 

TICCH== 

.TICCI== 

TICCJ== 

TICCK== 

TICCL== 

TICCM== 

TICCN== 

,TICCO== 

,TICCP== 

,TICCQ== 

,TICCR== 

TICCS== 

TICCT== 

,TICCU== 

TICCV== 

TICCW== 

TICCX== 

TICCY== 

TICCZ== 

TICES== 

TICRB== 

TICSP== 

TICRF== 

TICTI== 

TICTO== 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 



BREAK 

"A 

~B 

~C 

~D 

~E 

~F 

~G 

~H 

"I 

"J 

"K 

~L 

~M 

~N 

~0 

"P 

~Q 

~R 
~S 
~T 
~U 
"V 
~W 

~x 

~Y 

~z 

ESC 

RUBOUT 

SPACE 

CARRIER OFF 

TYPEIN 

TYPEOUT 
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SC%CTC== 


1B0 




SC%GTB==- 


1B1 




SC%MMN== 


1B2 




SC%LOG== 


1B3 




SC%MPP== 


1B4 




SC%SDV== 


1B5 




SC%SCT==- 


1B6 




SC%SUP==: 


1B9 




SC%FRZ== 


1B17 




SC%WHL== 


1B18 




SC%OPR== 


1B19 




SC%CNF== 


1B20 




SC%MNT== 


1B21 




SC%IPC== 


1B22 




SC%ENQ== 


1B23 




SC%NWZ== 


1B24 


;TOPS20AN 


SC%NAS== 


1B25 


; TOPS 2 AN 


SC%DNA== 


1B26 




SC%ANA== 


:1B27 


;TOPS20AN 



CONTROL-C 

GETAB 

MAP MONITOR 

LOGGING FUNCTIONS 

MAP PRIVILEGED PAGES 

SPECIAL DEVICES 

ASSIGN TTY AS CONTROLLING FOR FORK (SCTTY) 

; SUPERIOR ACCESS 

; FREEZE ON TERMINATING CONDITIONS 

WHEEL 

OPERATOR 

CONFIDENTIAL INFORMATION ACCESS 

MAINTENANCE 

IPCF PRIVILEGES 

ENQ/DEQ PRIVILEGES 

NET WIZARD PRIVILEGES (ASNSQ, ETC.) 

NETWORK ABSOLUTE SOCKET PRIVILEGE 

DECNET ACCESS ALLOWED 

ARPANET ACCESS ALLOWED 



; OUTMODED NAMES FOR BITS IN DIRECTORY MODE WORD - USE CD%XXX 
EQUIVALENTS 



MD%FO==:CD%DIR 
MD%SA==:CD%ANA 
MD%RLM==:CD%RLM 



FILES ONLY DIRECTORY 
STRING ACCOUNT ALLOWED 
REPEAT LOGIN MESSAGE 
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FBHDR==: 









FB%LEN== 


177B35 




FBCTL==: 


1 






FB%TMP== 


1B0 




FB%PRM== 


1B1 




FB%NEX== 


1B2 




FB%DEL== 


1B3 




FB%NXF== 


1B4 




FB%LNG== 


1B5 




FB%SHT== 


1B6 




FB%DIR== 


1B7 




FB%NOD== 


1B8 




FB%BAT== 


1B9 




FB%SDR== 


1B10 




FB%ARC== 


1B11 




FB%INV== 


1B12 




FB%OFF== 


1B13 




FB%FCF== 


17B17 






. FBNRM= 


= =:0 






.FBRMS= 


= =:1 




FB%NDL== 


1B18 




FB%WNC== 


IB 19 




FBEXL== 


2 






FBADR== 


3 






FBPRT== 


4 






FBCRE== 


5 






FBUSE== 


6 






FBAUT== 


6 






FBGEN== 


7 






I 


n B%GEN== 


777777B17 




FBDRN== 


7 






I 


n B%DRN== 


\111111 




FBACT== 


10 






FBBYV== 


11 






I 


n B%RET== 


77B5 




I 


n B%BSZ== 


77B11 




I 


n B%MOD== 


:17B17 




I 


n B%PGC== 


-.111111 ;PAGE 


COL 


FBSIZ== 


12 






FBCRV== 


13 






FBWRT== 


14 






FBREF== 


15 






FBCNT== 


16 






FBBK0== 


17 






FBBK1== 


20 






FBBK2== 


21 






FBBBT== 


22 






I 


^R%RAR== 


1B1 




I 


^R%PIV== 


■1B2 




I 


^R%NDL== 


1B3 




I 


^R%NAR== 


1B4 




I 


^R%EXM== 


1B5 




I 


^R%1ST== 


1B6 




I 


^R%RFL== 


:1B7 




I 


^R%WRN== 


1B8 




I 


^R%RSN== 


7B17 






.AREXP= 


= =:1 






.ARARR= 


= =:2 






. ARRIR- 


= =:3 




T 


^R%PSZ== 


111111 ; RH 


is x. 



HEADER WORD 

LENGTH OF THIS FDB 

FLAGS 

FILE IS TEMPORARY 

FILE IS PERMANENT 

FILE DOES NOT HAVE AN EXTENSION YET 

FILE IS DELETED 

FILE IS NONEXISTENT 

FILE IS A LONG FILE 

FILE HAS COMPRESSED PAGE TABLE 

FILE IS A DIRECTORY FILE 

FILE IS NOT TO BE DUMPED BY BACKUP SYSTEM 

FILE HAS AT LEAST ONE BAD PAGE IN IT 

THIS DIRECTORY HAS SUBDIRECTORIES 

File has archive status 

File is invisible 

File is offline 
FILE CLASS FIELD 
NON-RMS 
RMS FILES 

FILE CANNOT BE DELETED 
LAST WRITE NOT CLOSED 
LINK TO FDB OF NEXT EXTENSION 
DISK ADDRESS OF INDEX BLOCK 
PROTECTION OF THE FILE 
TIME AND DATE OF LAST WRITE 
LAST WRITER ,, AUTHOR (OBS) 
POINTER TO AUTHOR STRING 
GENERATION , , DIR # 
GENERATION NUMBER 
GENERATION , , DIR # 
DIR NUMBER 
ACCOUNT 

RETENTION+BYTE SIZE+MODE , , # OF PAGES 
RETENTION COUNT 
BYTE SIZE 
LAST OPENF MODE 
NT 

EOF POINTER 

TIME AND DATE OF CREATION OF FILE 
TIME AND DATE OF LAST USER WRITE 
TIME AND DATE OF LAST NON-WRITE ACCESS 
# OF REFERENCES 
(5) 



# OF WRITES , , 
BACKUP WORDS 



pg 



Bits,,#pages in offline file 
Request archive by usee 
Request invol migration by system 
Do not delete contents of file when archived 
Please don't migrate this file 
File exempt from migration 

1st pass of archive/collection run complete 
Retrieve failed 

USER WARNED OF APPROACHING EXPIRATION 
Reason pushed offline 
File expired 
Archive was requested 
Migration was requested 
count when file went offline 
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FBNET= 
FBUSW= 
FBGNL= 
FBNAM= 
FBEXT= 
FBLWR= 
FBTDT= 
FBFET= 
FBTP1= 
FBSS1= 
FBTP2 = 
FBSS2= 



23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 



On-line expiration date/interval 
USER SETTABLE WORD 
LINK TO NEXT GENERATION FILE 
POINTER TO NAME BLOCK 
POINTER TO EXTENSION BLOCK 
POINTER TO LAST WRITER STRING 

Archive or collection date & time 

Offline expiration date/interval 

Tape ID for run 1 tape 

Saveset #,,Tape file # for run 1 tape 

Tape ID for run 2 tape 

Saveset #,,Tape file # for run 2 tape 



FBLN0= 
FBLN1= 
FBLXT= 
FBLEN= 



30 

31 
37 
37 



LENGTH OF VERSION FDB 
LENGTH OF VERSION 1 FDB 

Minimum length for archive/virtual dsk sys 
LENGTH OF THE FDB 



B-77 



MONSYM 



;CARD READER DEFINITIONS 
•CRILC==:"\" 



; ILLEGAL CHARACTER CODE 



;A WORD IS DISTINGUISHED FROM A BYTE POINTER BY THE VALUE 5 IN BITS 0-2 
;USE THESE DEFINITIONS TO TEST FOR A NUMBER AS FOLLOWS: 

LOAD AC,NMFLG,LOC 

CAIE AC,NUMVAL 

NMFLG==:7B2 
NUMVAL==:5 



; MAGTAPE LABEL TYPES 



.LTUNL== 
.LTANS== 
.LTEBC== 
.LTT20== 
.LTMAX== 



; MAGTAPE LABEL STATES 



.LSUNL== 
.LSPRI== 
.LSSCR== 
.LSUSC== 



MAGTAPE DRIVE TYPES 



.TMDR9== 
.TMDR7== 
•TMDMX== 



UNLABELED 

ANSI STANDARD 

EBCDIC 

TOPS-20 

MAXIMUM LABEL TYPE 



UNLABELLED VOLUME 
PRIVATE VOLUME 
SCRATCH VOLUME 
USER SCRATCH VOLUME 



9-TRACK 
7-TRACK 
MAXIMUM DRIVE-TYPE VALUE 



; DEFINITIONS FOR COMMUNICATIONS PROTOCOLS 
; DEFINE THE SUPPORTED PROTOCOL TYPES 



.VN20F== 
.VNMCB== 
.VND60== 
.VNDDC== 
.VNMOP== 
.VNCNL== 
.VNCBL== 



RSX20F PROTOCOL 

MCB DECNET PROTOCOL 

DN6 PROTOCOL 

DDCMP PROTOCOL 

MOP (DDCMP MAINTENANCE) MODE 

CONTROLLER LOOPBACK 

CABLE LOOPBACK 



;DEFINE BITS USED WHEN RELOADING AN -11 

RM%ROM==:1BO ;IF SET, ACTIVATE ROM 
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; GENERAL FIELD AND VALUE DEFINITIONS 
;USED BY TOPS20AN JSYS'S 

; STATES OF A CONNECTION IN ARPANET NCP 

; RETURNED IN B0-B3 OF GDSTS ON A NET CONNECTION 

; ALSO AVAILABLE IN A GETAB , BUT THAT'S NOT THE PREFERRED WAY 

; TO READ THEM, IF YOU HAVE A JFN FOR THE CONNECTION. 



NSCZD== 
NSPND== 
NSLSN== 
,NSRCR= = 
,NSCW1== 
NSRCS== 
NSOPN== 
,NSCSW== 
,NSDTW== 
,NSRF1== 
,NSCZW== 
,NSRF2== 
,NSFRE== 



01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
16 



CLOSED 

PENDING 

LISTENING 

REQUEST FOR CONNECTION RECEIVED 

CLOSE WAIT SUB ONE (NCP CLOSE) 

REQUEST FOR CONNECTION SENT 

OPENED 

CLOSE WAIT (NCP CLOSE) 

FINAL DATA WAIT 

RFNM WAIT SUB ONE (NORMAL NCP CLOSE) 

CLOSE WAIT (PROGRAM CLOSE) 

RFNM WAIT SUB TWO (UNEXPECTED NCP CLOSE) 

FREE 



;HOST STATUS BITS 



HS%UP== 
HS%VAL= 
HS%DAY= 
HS%HR== 
HS%MIN= 
HS%RSN= 
HS%SRV= 
HS%USR= 
HS%NCK= 
HS%STY= 
HS%NEW= 
HS%NAM= 



= 1B0 
= = 1B1 
= = 7B4 
= 37B9 
= = 17B13 
= = 17B17 
= = 1B18 
= = 1B19 
= = 1B20 
==77B26 
= = 1B27 
= = 1B28 



HOST IS UP 

VALID STATUS 

DAY WHEN UP IF DOWN 

HOUR 

5 MIN INTERVAL 

REASON 

HOST IS SERVER 

HOST IS USER 

HOST NAME STRING WAS NICKNAME 

SYSTEM TYPE MASK 

HOST DOES NEW PROTOCOL 

HOST HAS NAME 



HS10X= 
HSITS= 
HSDEC= 
HSTIP= 
HSMTP= 
HSELF= 
HSANT= 
HSMLT= 
HST20= 
HSUNX= 



= 1B26 
= 2B26 
= 3B26 
= 4B26 
= 5B26 
= 6B26 
= 7B26 
=10B26 
=11B26 
=12B26 



TENEX 

ITS 

TOPS- 10 

TIP 

MTIP 

ELF 

ANTS 

MULTICS 

TOPS-20 

UNIX 
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; ERROR CODE DEFINITIONS 
.ERBAS==:600000 
DEFINE .ERCOD < 



;BASE VALUE FOR ALL ERROR CODES 



ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

, ERR 

, ERR 

, ERR 

,ERR 

, ERR 

, ERR 

,ERR 

, ERR 
, ERR 
, ERR 
ERR 
, ERR 
, ERR 
,ERR 
..ERR 
, ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
, ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 



10,LGINXl,<Invalid account identified) 

11 ,LGINX2 , <Directory is "files-only" and cannot be logged in to>) 

12 , LGINX3 , <Internal format of directory is incorrect>) 

13,LGINX4,<Invalid password>) 

14,LGINX5,<Job is already logged in>) 

20 , CRJBX1 , <Invalid parameter or function bit combinat ion> ) 

21,CRJBX2,<Illegal for created job to enter MINI-EXEC)) 

2 2,CRJBX3,<Reserved>) 

23,CRJBX4,<Terminal is not available>) 

24,CRJBX5,<Unknown name for LOGIN>) 

25 ,CRJBX6 , <Insuf f icient system resources)) 

26,CRJBX7,<Reserved>) 

35, LOUTX1 ,<I1 legal to specify job number when logging out own job>) 

36,LOUTX2,<Invalid job number)) 

45,CACTXl,<Invalid account identifier)) 

46,CACTX2,<Job is not logged in>) 

50,EFCTX1,<WHEEL or OPERATOR capability required)) 

51,EFCTX2,<Entry cannot be longer than 64 words)) 

52,EFCTX3,<Fatal error when accessing FACT file)) 

55,GJFXl,<Desired JFN invalid)) 

56,GJFX2,<Desired JFN not available)) 

57,GJFX3,<No JFN available)) 

60 ,GJFX4 ,<Invalid character in filename)) 

61 ,GJFX5, <Field cannot be longer than 39 characters)) 

62 ,GJFX6 , <Device field not in a valid position)) 

63 ,GJFX7 , <Directory field not in a valid position)) 

64 ,GJFX8 , <Directory terminating delimiter is not preceded by a valid 

beginning delimiter)) 

65 ,GJFX9 , <More than one name field is not allowed)) 

66 ,GJFX10 , <Generat ion number is not numeric)) 

67 ,GJFX11 , <More than one generation number field is not allowed)) 

70 ,GJFX12 , <More than one account field is not allowed)) 

71 ,GJFX13 , <More than one protection field is not allowed)) 

72,GJFX14,<Invalid protection)) 

73 ,GJFX15 , <Invalid confirmation character)) 

74 ,GJFXl6,<No such device)) 

75,GJFX17 , <No such directory name)) 

76,GJFXl8,<No such filename)) 

77,GJFXl9,<No such file type)) 

100 ,GJFX20 , <No such generation number)) 

101,GJFX21,<File was expunged)) 

102 ,GJFX22 , insufficient system resources (Job Storage Block full))) 

103 ,GJFX23 , <Exceeded maximum number of files per directory)) 

104,GJFX24, <File not found)) 

107,GJFX27,<File already exists (new file required))) 

110,GJFX28,<Device is not on line)) 

lll,GJFX29,<Device is not available to this job)) 

112 ,GJFX30 , <Account is not numeric)) 

113,GJFX31,<Invalid wildcard designator)) 

114,GJFX32,<No files match this specification)) 

115 ,GJFX33 , <Filename was not specified)) 

116,GJFX34, <Invalid character "?" in file specification)) 

117 ,GJFX35 , <Directory access privileges required)) 

120,OPNXl,<File is already open)) 

121,OPNX2,<File does not exist)) 

122 ,OPNX3 , <Read access required)) 

123 ,OPNX4 , <Wr ite access required)) 
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ERR 


(124, 


ERR 


(125, 


ERR 


(126, 


ERR 


127, 


ERR 


130, 


ERR 


(131, 


ERR 


133, 


ERR 


r 134, 


ERR 


135, 


ERR 


136, 


ERR 


137, 


ERR 


140, 


ERR 


141, 


ERR 


142, 


ERR 


143, 


ERR 


144, 


ERR 


145, 


ERR 


150, 


ERR 


151, 


ERR 


152, 


ERR 


153, 


ERR 


154, 


ERR 


155, 


ERR 


156, 




wild 


ERR 


157, 


ERR 


160, 


ERR 


161, 


ERR 


165, 


ERR 


166, 


ERR ( 


167, 


ERR 


170, 


ERR ( 


175, 


ERR 


176, 


ERR 


177, 


ERR ( 


200, 


ERR 


202, 


ERR 


204, 


ERR 


210, 


ERR 


211, 


ERR 


215, 


ERR ( 


216, 


ERR 


217, 


ERR 


220, 


ERR 


221, 


ERR 


222, 


ERR ( 


240, 


ERR ( 


241, 


ERR ( 


245, 


ERR 


250, 


ERR ( 


251, 


ERR ( 


252, 


ERR ( 


253, 


ERR 


254, 


ERR ( 


255, 


ERR 


260, 


ERR 


261, 


ERR ( 


262, 


ERR 


267, 


ERR ( 


270, 


ERR 


271, 


ERR 


273, 


ERR 


275, 



by this process)) 
accumulate filename)) 



OPNX5 , (Execute access required)) 

OPNX6 , <Append access required)) 

OPNX7 ,<Device already assigned to another job)) 

OPNX8,<Device is not on line)) 

OPNX9 , <Inval id simultaneous access)) 

OPNX10,<Entire file structure full)) 

OPNX12 , <List access required)) 

OPNX13 , <Inval id access requested)) 

OPNX14 , (Invalid mode requested)) 

OPNX15 ,<Read/wr ite access required)) 

OPNX16,(File has bad index block)) 

OPNX17,<No room in job for long file page table)) 

OPNX18,<Unit Record Devices are not available)) 

0PNX19,(IMP is not up)) ;TOPS20AN 

OPNX20,<Host is not up)) ;TOPS20AN 

OPNX21,<Connection refused)) ;TOPS20AN 

OPNX22,<Connection byte size does not match)) ;TOPS20AN 

DESXl ,<Invalid source/destination designator)) 

DESX2, (Terminal is not available to this job)) 

DESX3,<JFN is not assigned)) 

DESX4 , <Inval id use of terminal designator or string pointer)) 

DESX5,<File is not open)) 

DESX6, <Device is not a terminal)) 

DESX7 , <Illegal use of parse-only JFN or output 

card-designators)) 

DESX8,<File is not on disk)) 

CLSXl,<File is not open)) 

CLSX2,<File cannot be closed 

RJFNXl,<File is not closed)) 

RJFNX2,<JFN is being used to 

RJFNX3,<JFN is not accessible by this process)) 

DELFX1 ,<Delete access required)) 

SFPTXl,<File is not open)) 

SFPTX2,<Illegal to reset pointer for this file)) 

SFPTX3,<Invalid byte number)) 

CNDIXl,<Invalid password)) 

CNDIX3 , <Invalid directory number)) 

CNDIX5,<Job is not logged in)) 

SFBSX1 , <I1 legal to change byte size for this opening of file)) 

SFBSX2,<Invalid byte size)) 

IOXl,<File is not opened for reading)) 

IOX2,<Filo is not opened for writing)) 

IOX3,<File is not open for random access)) 

IOX4, <End of file reached)) 

IOX5, <Dev:lce or data error)) 

IOX6 , <Illegal to write beyond absolute end of file)) 

PMAPX1 , <Invalid access requested)) 

use of PMAP) ) 

access requested)) 

process handle)) 

to manipulate a superior process)) 
FRKHX3 , <Invalid use of multiple process handle)) 
FRKHX4 , (Process is running)) 
FRKHX5, (Process has not been started)) 
FRKHX6,<A11 relative process handles in use)) 
SPLFX1, (Process is not inferior or equal to self)) 
SPLFX2, (Process is not inferior 
SPLFX3,(New superior process is 
GTABX1, (Invalid table number)) 
GTABX2, (Invalid table index)) 
GTABX3,(GETAB capability required)) 
RUNTX1, (Invalid process handle -3 or -4>) 
STADX1, (WHEEL or OPERATOR capability required)) 



PMAPX2, (Invalid 
SPACX1, (Invalid 
FRKHX1, (Invalid 
FRKHX2, (Illegal 



to self)) 
inferior to 



intended inferior)) 
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ERR 

ERR 

ERR 

ERR 

,ERR 

, ERR 

, ERR 

, ERR 

,ERR 

,ERR 

, ERR 

, ERR 

,ERR 

, ERR 

, ERR 

,ERR 

, ERR 

, ERR 

ERR 

,ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

,ERR 

, ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

,ERR 

, ERR 

,ERR 

ERR 

ERR 

ERR 

, ERR 

,ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

ERR 



(276, 


(300, 


(301, 


(302, 


(320, 


(321, 


(322, 


(323, 


(324, 


(332, 


(335, 


(336, 


(337, 


(345, 


(346, 


(347, 


(350, 


(351, 


(352, 


(353, 


(356, 


(357, 


(360, 


(361, 


(362, 


(363, 


(365, 


(366, 


(367, 


(370, 


(371, 


(373, 


(374, 


(375, 


(376, 


(377, 


(407, 


(410, 


(411, 


(414, 


(415, 


(416, 


(424, 


(425, 


(426, 


(430, 


(431, 


(432, 


(433, 


(440, 


(441, 


(442, 


(443, 


(450, 


(451, 


(452, 


(453, 


(454, 


(460, 


(461, 


(462, 


(464, 


(465, 



,STADX2,<Invalid date or time>) 

, ASNDX1 , <Device is not assignable>) 

,ASNDX2,<Illegal to assign this device >) 

,ASNDX3,<No such device>) 

,ATACXl,<Invalid job number)) 

,ATACX2,<Job already attached^ 

, ATACX3 , <Incorrect user number>) 

,ATACX4,<Invalid password)) 

,ATACX5,<This job has no controlling terminal)) 

,STDVXl,<No such device)) 

,DEVX1 , <Inval id device designator)) 

,DEVX2 , <Device already assigned to another job)) 

,DEVX3,<Device is not on line)) 

,MNTX1 , <Internal format of directory is incorrect)) 

,MNTX2,<Device is not on line)) 

,MNTX3,<Device is not mountable)) 

,TERMXl,<Invalid terminal code)) 

,TLNKX1 , <Illegal to set remote to object before object to remote)) 

, ATIX1 , <Invalid software interrupt channel number)) 

,ATIX2,<Control-C capability required)) 

,TLNKX2 , <Link was not received within 15 seconds)) 

,TLNKX3,<Links full)) 

,TTYXl,<Device is not a terminal)) 

,RSCNX1 , <Overf lowed rescan buffer, input string truncated)) 

,RSCNX2,<Invalid function code)) 

,CFRKX3 , <Insuf f icient system resources)) 

,KFRKXl,<Illegal to kill top level process)) 

,KFRKX2,<Illegal to kill self)) 

, RFRKX1 , <Processes are not frozen)) 

,HFRKXl,<Illegal to halt self with HFORK)) 

,GFRKXl,<Invalid process handle)) 

,GETXl,<Invalid save file format)) 

,GETX2,<System Special Pages Table full)) 

,TFRKXl,<Undef ined function code)) 

,TFRKX2 , <Unassigned fork handle or not immediate inferior)) 

, SFRVX1 , <Inval id position in entry vector)) 

,NOUTXl,<Radix is not in range 2 to 36 >) 

,NOUTX2,<Column overflow)) 

,TFRKX3,<Fork (s) not frozen)) 

,IFIXXl,<Radix is not in range 2 to 10>) 

,IFIXX2,<First nonspace character is not a digit)) 

,IFIXX3,<Overflow (number is greater than 2**35 )>) 

,GFDBX1 ,<Invalid displacement)) 

,GFDBX2,<Invalid number of words)) 

,GFDBX3 , <List access required)) 

,CFDBXl,<Invalid displacement)) 

,CFDBX2,<Illegal to change specified bits)) 

,CFDBX3 , <Wr ite or owner access required)) 

,CFDBX4,<Invalid value for specified bits)) 

,DUMPXl,<Command list error)) 

,DUMPX2,<JFN is not open in dump mode)) 

,DUMPX3 , <Address error (too big or crosses end of memory))) 

,DUMPX4 , <Access error (cannot read or write data in memory))) 

,RNAMX1 , <Files are not on same device)) 

,RNAMX2 , <Dest ination file expunged)) 

, RNAMX3 , <Wr ite or owner access to destination file required)) 

, RNAMX4 , <Quota exceeded in destination of rename)) 

,BKJFX1 , <Illegal to back up terminal pointer twice)) 

,TIMEX1 , <Time cannot be greater than 24 hours)) 

, ZONEXl,<Tirne zone out of range)) 

,ODTNXl ,<Time zone must be USA or Greenwich)) 

,DILFX1 ,<Inva] id date format)) 

,TILFXl,<Invalid time format)) 



B-82 



MONSYM 



ERR 
, ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
, ERR 
, ERR 
, ERR 
.ERR 
ERR 



(466, 


(467, 


(470, 


(471, 


(472, 


(473, 


(516, 


(530, 


(531, 


(532, 


(533, 


(540, 


(541, 


(544, 


(545, 


(546, 


(555, 


(560, 


(570, 


(600, 


(601, 


(610, 


(614, 


(615, 


(617, 


(620, 


(621, 


(622, 


(623, 


(624, 


(626, 


(640, 


(641, 


(650, 


(651, 


(652, 


(653, 


(660, 


(661, 


(662, 


(670, 


(700, 


(701, 


(704, 


(705, 


(707, 


(710, 


(711, 


(712, 


(713, 


(714, 


(715, 


(716, 


(717, 


(720, 


(721, 


(722, 


(723, 


(724, 


(727, 


(730, 


(731, 


(732, 



,DATEXl,<Year out of range)) 

,DATEX2,<Month is not less than 12>) 

,DATEX3,<Day of month too large>) 

,DATEX4,<Day of week is not less than 7>) 

,DATEX5,<Date out of range)) 

,DATEX6, <System date and time are not set)) 

,SMONXl,<WHEEL or OPERATOR capability required)) 

,SACTX1 , <File is not. on multiple-directory device)) 

,SACTX2 , <Insuf f icient system resources (Job Storage Block full))) 

, SACTX3 , <Directory requires numeric account)) 

, SACTX4 , <Wr i te or owner access required)) 

,GACTX1 , <File is not on multiple-directory device)) 

,GACTX2,<File expunqed)) 

,FFUFXl,<File is not open)) 

, FFUFX2 , <File is not on multiple-directory device)) 

,FFUFX3,<No used page found)) 

,DSMXl,<File (s) not closed)) 

,RDDIXl , <Illegal to read directory for this device)) 

,SIRXl,<Table address is not greater than 20>) 

,SSAVX1 , <Illegal to save files on this device)) 

,SSAVX2,<Page count (left half of table entry) must be negative)) 

,SEVEXl,<Entry vector length is not less than 1000)) 

,WHELX1,<WHEEL or OPERATOR capability required)) 

,CAPX1,<WHEEL or OPERATOR capability required)) 

,PEEKX2, <Read access failure on monitor page)) 

,CRDIX1,<WHEEL or OPERATOR capability required)) 

,CRDIX2 , <Illegal to change number of old directory)) 

,CRDIX3, <Insuff icient system resources (Job Storage Block full))) 

,CRDIX4,<Superior directory full)) 

, CRDIX5 , <Directory name not given)) 

,CRDIX7,<File (s) open in directory)) 

,GTDIX1,<WHEEL or OPERATOR capability required)) 

,GTDIX2,<Invalid directory number)) 

, FLINX1 , <First character is not blank or numeric)) 

,FLINX2,<Number too small)) 

, FLINX3,<Number too large)) 

,FLINX4,<Invalid format)) 

,FLOTXl ,<Column overflow in field 1 or 2>) 

, FLOTX2,<Co.lumn overflow in field 3>) 

,FLOTX3,<Invalid format specified)) 

,HPTXl,<Undefined clock number)) 

,FDFRXl,<Not a multiple-directory device)) 

,FDFRX2,<Invalid directory number)) 

,GTHSXl,<Unknown host number)) ;TOPS20AN 

,GTHSX2,<No number for that host name)) ;TOPS20AN 

,GTHSX3,<No string for that Host number)) ;TOPS20AN 

,ATNXl,<Invalid receive JFN>) ;TOPS20AN 

,ATNX2,<Receive JFN not opened for read)) ;TOPS20AN 

,ATNX3,<Receive JFN not open)) ;TOPS20AN 

,ATNX4,<Recoive JFN is not a NET connection)) ;TOPS20AN 

,ATNX5,<Receive JFN has been used)) ;TOPS20AN 

,ATNX6,<Receive connection refused)) ;TOPS20AN 

,ATNX7,<Invalid send JFN>) ;TOPS20AN 

,ATNX8,<Send JFN not opened for write)) ;TOPS20AN 

,ATNX9,<Send JFN not open)) ;TOPS20AN 

,ATNX10,<Send JFN is not a NET connection)) ;TOPS20AN 

,ATNXll,<Send JFN has been used)) ;TOPS20AN 

,ATNX12,<Send connection refused)) ;TOPS20AN 

,ATNX13,<Insuff icient system resources (No NVT's))) ;TOPS20AN 

,CVHSTl,<No string for t>at Host number)) ;TOPS20AN 

,CVSKXl,<Invalid network JFN>) ;TOPS20AN 

,CVSKX2,<Local socket invalid in this context)) ;TOPS20AN 

,SNDIXl,<Invalid message size)) ;TOPS20AN 



B-83 



MONSYM 



ERR 

ERR 
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ERR 
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ERR 

ERR 
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.ERR 

.ERR 

.ERR 
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.ERR 

.ERR 

.ERR 
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,ERR 
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(733 ,SNDIX2 , <Insuf f icient system resources (No b 
;TOPS2 0AN 

734,SNDIX3,<Illegal to specify NCP links 0-72 
735 , SNDIX4 , <Inval id header value for this queue 
736,SNDIX5,<IMP down)) ;TOPS20AN 

737,NTWZX1,<NET WIZARD capability required)) ; 
740 ,ASNSX1 , <Insuff icient system resources (All 
; TOPS 2 AN 

741 , ASNSX2 ,<Link (s) assigned to another special 
742 ,SQX1 , <Special network queue handle out of r 
743 ,SQX2 , <Special network queue not assigned)) 
746,GTNCXl,<Invalid network JFN>) ;TOPS20AN 
747,GTNCX2,<Invalid or inactive NVT>) ;TOPS20AN 
750, PNAMX5, destination file is not closed)) 
751 ,RNAMX6 , <Destinat ion file has bad page table 
752,RNAMX7,<Source file expunged)) 
753 ,RNAMX8 , <Wr ite or owner access to source fil 
754 ,RNAMX9 , <Source file is nonexistent)) 
755,RNMX10,<Source file is not closed)) 
756 ,RNMX11 , <Source file has bad page table)) 
757,RNMX12,<Illegal to rename to self)) 
760 ,GJFX36 , <Internal format of directory is inc 
770, ILINS1, <Undef ined operation code)) 
771,ILINS2,<Undefined JSYS>) 
772 , ILINS3 , <UUO simulation facility not availab 



1000 
1001 
1002 
1003 
1004 
1005 
1006 
1007 
1010 
1011 
1013 
1014 
1015 
1016 
1017 
1020 
1021 
1022 
1023 
1024 
1025 
1026 
1027 
1030 
1031 
1032 
1033 
1034 
10 35 
1036 
1037 
1040 
1041 
1042 
1043 
1044 
1045 
1046 



CRLNX1 , <Logical name is not defined)) 

INLNX1 , <Index is beyond end of logical nam 

LNSTXl,<No such logical name)) 

MLKBX1 , <Lock facility already in use)) 

MLKBX2 , <Too many pages to be locked)) 

MLKBX3,<Page is not available)) 

MLKBX4 , <Illegal to remove previous content 

VBCXl , <Display data area not locked in cor 

RDTXl,<Invalid string pointer)) 



uffers available))) 

>) ; TOPS 20 AN 
>) ;TOPS20AN 

TOPS2 0AN 

special queues in use))) 

queue)) ;TOPS20AN 
ange)) ; TOPS 2 AN 
; TOPS 20 AN 



>) 

e required)) 

o r r e c t > ) 

le>) 

e table)) 



s of user map)) 
e>) 



GFKSX1 
GTJIX1 
GTJIX2 
GTJIX3 
IPCFX1 
IPCFX2 
IPCFX3 
IPCFX4 
IPCFX5 
IPCFX6 
IPCFX7 
IPCFX8 
IPCFX9 
IPCF10 
IPCF11 
IPCF12 
IPCF13 
IPCF14 
IPCF15 
IPCF16 
IPCF17 
IPCF18 
IPCF19 
IPCF20 
IPCF21 
IPCF22 
IPCF23 
IPCF24 
IPCF25 



<Area too small to hold process structure)) 

<Invalid index)) 

<Invalid terminal line number)) 

<Invalid job number)) 

<Length of packet descriptor block cannot be less than 4>) 

<No message for this PID>) 

<Data too long for user's buffer)) 

^Receiver's PID invalid)) 

<Receiver's PID disabled)) 

<Send quota exceeded)) 

<Receiver quota exceeded)) 

<IPCF free space exhausted)) 

<Sender's PID invalid)) 

<WHEEL capability required)) 

<WHEEL or IPCF capability required) 

<No free PID's available)) 

<PID quota exceeded)) 

<No PID's available to this job)) 

<No PID's available to this process: 

<Receive and message data modes do 

<Argument block too small)) 

<Invalid MUTIL JSYS function)) 

<No PID for [SYSTEM] INFO)) 

<Invalid process handle)) 

<Invalid job number)) 

<Invalid software interrupt channel number)) 

< [SYSTEM] INFO already exists)) 

<Invalid message size)) 

<PID does not belong to this job)) 



) 



D) 
not match) 
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ERR 
ERR 

, ERR 
ERR 
ERR 

, ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 



(1047, 


(1050, 


(1051, 


(1052, 


(1053, 


(1054, 


(1055, 


(1056, 


(1057, 


(1060, 


(1061, 


(1062, 


(1063, 


(1064, 


(1065, 


(1066, 


(1067, 


(1070, 


(1071, 


(1072, 


(1073, 


(1074, 


(1075, 


(1076, 


(1077, 


(1100, 


(1101, 


(1102, 


(1103, 


(1104, 


(1105, 


(1106, 


(1107, 


(1110, 


(1111, 


(1112, 


(1113, 


(1114, 


(1115, 


(1116, 


(1117, 


(1120, 


(1121, 


(1122, 


(1123, 


(1124, 


(1125, 


(1126, 


(1127, 


(1130, 


(1131, 


(1132, 


(1133, 


(1134, 


(1135, 


(1136, 


(1137, 


(1140, 


(1141, 


(1142, 


(1143, 


(1144, 


(1145, 



,IPCF26,<PID does not belong to this process)) 

,IPCF27,<PID is not defined>) 

,IPCF28,<PID not accessible by this process)) 

,IPCF29,<PID already being used by another process)) 

,IPCF30,<Job is not logged in>) 

,GNJFXl,<No more files in this specification)) 

,ENQXl,<Invalid function)) 

,ENQX2 , <Level number too small)) 

,ENQX3 , <Request and lock level numbers do not match)) 

, ENQX4 , <Nurnber of pool and lock resources do not match)) 

,ENQX5 ,<Lock already requested)) 

,ENQX6 ,<Requested locks are not all locked)) 

,ENQX7,<No ENQ on this lock)) 

,ENQX8 , <Inval id access change requested)) 

, ENQX9 , <Invalid number of blocks specified)) 

,ENQX10,<Invalid argument block length)) 

, ENQX11 , <Inval id software interrupt channel number)) 

, ENQX12 , <lnval id number of resources requested)) 

,ENQX13 ,<Indirect or indexed byte pointer not allowed)) 

,ENQX14,<Invalid byte size)) 

, ENQX15,<ENQ/DEQ capability required)) 

,ENQX16,<WHEEL or OPERATOR capability required)) 

,ENQXl7,<Invalid JFN>) 

,ENQX18,<Quota exceeded)) 

,ENQX19,<String too long)) 

,ENQX20,<Locked JFN cannot be closed)) 

,ENQX21,<Job is not logged in)) 

, IPCF31 , <Invalid page number)) 

,IPCF32,<Page is not private)) 

,PMAPX3 , <Illegal to move shared page into file)) 

,PMAPX4 , <Illegal to move file page into process)) 

,PMAPX5 , <Illegal to move special page into file)) 

,PMAPX6,<Eisk quota exceeded)) 

,SN0PX1,<WHEEL or OPERATOR capability required)) 

,SNOPX2,<Invalid function)) 

,SNOPX3,<.SNPLC function must, be first)) 

,SNOPX4,<Only one . SNPLC function allowed)) 

,SNOPX5 , <Invalid page number)) 

, SNOPX6 , <Invalid number of pages to lock)) 

, SNOPX7 , <Illegal to define breakpoints after inserting them)) 

,SNOPX8 , breakpoint is not set on instruction)) 

,SNOPX9,<No more breakpoints allowed)) 

,SNOP10 , breakpoints already inserted)) 

,SN0P11 , breakpoints not inserted)) 

,SNOP12 , <Inval id format for program name symbol)) 

,SNOPl3,<No such program name symbol)) 

, SNOPl4,<No such symbol)) 

,SNOP15,<Not enough free pages for snooping)) 

, SNOP1 6, <Multiply" defined symbol)) 

,IPCF33,<lnvalid index into system PID table)) 

,SNOP17 , breakpoint already defined)) 

,OPNX23,<Disk quota exceeded)) 

,GJFX37,<3nput deleted)) 

,CRLNX2,<WHEEL or OPERATOR capability required)) 

,INLNX2,<Invalid function)) 

,LNSTX2,<lnvalid function)) 

,ALCX1 ,<Invalid function)) 

,ALCX2,<WHEEL or OPERATOR capability required)) 

, ALCX3 , <Device is not assignable)) 

,ALCX4,<Invalid job number)) 

, ALCX5 , <Device already assigned to another job)) 

,SPLXl,<Invalid function)) 

,SPLX2, <Argument block too small)) 
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ERR ( 


1146 


SPLX3, 


ERR 


1147 


SPLX4, 


ERR 


1150 


SPLX5, 


ERR ( 


1151, 


GLSX3, 


ERR 


1152 


CRLNX3 


ERR 


1153 


ALCX6, 




when 


releas 


ERR 


1154 


CKAX1, 


ERR 


1155 


CKAX2, 


ERR ( 


1156, 


CKAX3, 


ERR 


1157 


TIMX1, 


ERR 


1160 


TIMX2, 


ERR ( 


1161, 


TIMX3, 


ERR 


1162, 


TIMX4, 


ERR 


1163 


SNOP18 


ERR 


1164 


GJFX38 


ERR 


1165 


GJFX39 


ERR 


1166 


CRDIX8 


ERR 


1167 


CRDIX9 


ERR 


1170 


CRDI10 




expar 


iding> ) 


ERR 


1171 


DELDXl 


ERR 


1172 


DELDX2 


ERR 


1173 


GACTX3 


ERR 


1174 


DIAGXl 


ERR 


1175 


DIAGX2 


ERR 


1176 


DIAGX3 


ERR 


1177 


DIAGX4 


ERR 


1200 


P DIAGX5 


ERR 


1201 


r DIAGX6 


ERR 


1202 


DIAGX7 


ERR 


1203 


DIAGX8 


ERR 


1204 


DIAGX9 


ERR 


1205 


DIAG10 


ERR 


1206 


SYEX1, 


ERR 


1207 


SYEX2, 


ERR 


1210 


MTOX1, 


ERR 


1211 


,10X7, < 


ERR 


1212 


IOX8, < 


ERR 


1213 


MTOX5, 


ERR 


1214 


DUMPX5 


ERR 


1215 


DUMPX6 


ERR 


1216 


IOX9, < 


ERR 


1217 


CLSX4, 


ERR 


1220 


MTOX2, 


ERR 


1221 


MTOX3, 


ERR 


1222 


MTOX4, 


ERR 


1223 


MTOX6, 


ERR 


1224 


r OPNX25 


ERR 


1225 


GJFX40 


ERR 


1226 


MTOX7, 


ERR 


1227 


LOUTX3 


ERR 


1230 


LOUTX4 


ERR 


1231 


CAPX2, 


ERR 


1232 


SSAVX3 




full) 


>) 


ERR 


1233 


r SSAVX4 


ERR 


1234 


TDELX1 


ERR 


r 1235 


,TADDX1 


ERR 


1236 


TADDX2 


ERR 


1237 


TLUKX1 


ERR 


1240 


IOX10, 


ERR 


1241 


CNDIX2 



<Invalid device designator>) 

<WHEEL or OPERATOR capability required>) 

<Illegal to specify as generation number for first file>) 

<File still mapped>) 

,<Invalid function>) 

<Device assigned to user job, but will be given to allocator 

ed>) 

<Argument block too small)) 

<Invalid directory number)) 

<Invalid access code>) 

<Invalid function)) 

<Invalid process handle)) 

<Tiine limit already set>) 

<Illegal to clear time limit)) 

,<Data page is not private or copy-on-wr i te> ) 

,<File not found because output-only device was specified)) 

,<Logical name loop detected)) 

,<Invalid directory number)) 

,<Internal format of directory is incorrect)) 

,<Maximum directory number exceeded; index table needs 

,<WHEEL or OPERATOR capability required)) 

,<Invalid directory number)) 

,<Internal format of directory is incorrect)) 

,<Invalid function)) 

,<Device is not assigned)) 

,<Argument block too small)) 

,<Invalid device type)) 

,<WHEEL, OPERATOR, or MAINTENANCE capability required)) 

,<Invalid channel command list)) 

,<Illegal to do I/O across page boundary)) 

,<No such device)) 

,<Unit does not exist)) 

,<Subunit does not exist)) 

<Unreasonable SPEAR block size)) 

<No buffer space available for SPEAR)) 

<Invalid function)) 

Insufficient system resources (Job Storage Block full))) 

Monitor internal error)) 

<Invalid hardware data mode for magnetic tape)) 

,<No-wait dump mode not supported for this device)) 

,<Dump mode not supported for this device)) 

Function legal for sequential write only)) 

<Device still active)) 

<Record size was not set before I/O was done)) 

<Function not legal in dump mode)) 

<Invalid record size)) 

<Invalid magnetic tape density)) 

,<Device is write locked)) 

,<Undefined attribute in file specification)) 

<WHEEL or OPERATOR capability required)) 

,<WHEEL or OPERATOR capability required)) 

,<LOG capability required)) 

<WHEEL, OPERATOR, or MAINTENANCE capability required)) 

, <Insuf f icient system resources (Job Storage Block 

,<Directory area of EXE file is more than one page)) 

,<Table is empty)) 

,<Table is full)) 

,<Entry is already in table)) 

,<Internal format of table is incorrect)) 

<Pecord is longer than user requested)) 

,<WHEEL or OPERATOR capability required)) 
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ERR 


1242 


CNDIX4 


ERR 


[1243 


r CNDIX6 


ERR 


(1244 


,SJBX1, 


ERR 


1245 


SJBX2, 


ERR 


1246 


SJBX3, 


ERR 


1247 


TMONXl 


ERR 


1250 


SMONX2 


ERR 


1251 


SJBX4, 


ERR 


1252 


SJBX5, 


ERR 


1253 


SJBX6, 


ERR 


1254 


GTJIX4 


ERR 


1255 


ILINS4 


ERR ( 


1256, 


ILINS5 


ERR 


1257 


COMNX1 


ERR 


1260 


COMNX2 


ERR 


1261 


COMNX3 


ERR 


1262 


COMNX4 


ERR 


1263 


PRAX1, 


ERR 


1264, 


PRAX2, 


ERR 


1265 


COMNX5 


ERR 


1266 


COMNX6 


ERR 


1267, 


COMNX7 


ERR 


127 


PRAX3, 


ERR ( 


1271 


CKAX4, 


ERR 


1272 


GACCX1 


ERR 


1273 


GACCX2 


ERR 


1274 


MTOX8, 


ERR 


1275 


DBRKX1 


ERR 


1276 


SJPRX1 


ERR 


1277 


GJFX41 


ERR 


1300 


GJFX42 


ERR 


1301 


GACCX3 


ERR ( 


1302, 


TIMEX2 


ERR 


1303, 


DELFX2 


ERR 


1304, 


DELFX3 


ERR ( 


1305, 


DELFX4 


ERR ( 


1306 


DELFX5 


ERR ( 


1307, 


DELFX6 


ERR ( 


1310, 


DELFX7 


ERR 


1311 


DELFX8 


ERR 


1312, 


FRKHX7 


ERR 


1313 


DIRX1, 


ERR 


1314 


DIRX2, 


ERR 


1315 


DIRX3, 


ERR 


1316 


UFPGX1 


ERR 


1317 


LNGFX1 


ERR 


1320 


IPCF34 


ERR 


1321, 


COMNX8 


ERR 


1322 


MTOX9, 


ERR 


1323 


MTOX10 


ERR 


1324 


MTOX11 


ERR 


1325 


MTOX12 


ERR ( 


1326, 


MTOX13 


ERR 


1327 


MTOX14 


ERR ( 


1330 


SAVX1, 


ERR ( 


1331 


MTOX15 


ERR 


1332 


MTOX16 


ERR 


1333 


LPINX1 


ERR 


1334 


LPINX2 


ERR 


1335 


LPINX3 


ERR 


1336 


MTOX17 


ERR 


1337 


LGINX6 


ERR 


1340 


DESX9, 



,<Invalid job number)) 

,<Job is not logged in>) 

<Invalid function)) 

<Invalid magnetic tape density)) 

<Invalid magnetic tape data mode>) 

,<Invalid TMON function)) 

,<Invalid SMON function)) 

<Invalid job number)) 

<Job is not logged in)) 

<WHEEL or OPERATOR capability required)) 

, <No such job)) 

,<UUO simulation is disabled)) 

,<RMS facility is not available)) 

,<Invalid COMND function code)) 

,<Field too long for internal buffer)) 

,<Ccmmand too long for internal buffer)) 

,<Invalid character in input)) 

<Invalid PRARG function code)) 

<No room in monitor data base for argument block)) 

,<Invalid string pointer argument)) 

,<Problem in indirect file)) 

,<Error in command)) 

<PRARG argument block too large)) 

<File is not on disk)) 

,<Invalid job number)) 

,<No such job)) 

<Argument block too long)) 

,<No interrupts in progress)) 

,<Job is not logged in)) 

,<F:Lle name must not exceed 6 characters)) 

,<File type must not exceed 3 characters)) 

, <Conf idential Information Access capability required)) 

,<Downtime cannot be more than 7 days in the future)) 

,<F:Lle cannot be expunged because it is currently open)) 

,<System scratch area depleted; file not deleted)) 

,<Directory symbol table could not be rebuilt)) 

,<D:Lrectory symbol table needs rebuilding)) 

,<Internal format of directory is incorrect)) 

,<FDB formatted incorrectly; file not deleted)) 

,<FDB not found; file not deleted)) 

,<Process page cannot exceed Illy) 

<Invalid directory number)) 

insufficient system resources)) 

<Internal format of directory is incorrect)) 

,<File is not open for write)) 

,<Page table does not exist and file not open for write)) 

,<Cannot receive into an existing page)) 

,<Number base out of range 2-10)) 

<Output still pending)) 

,<VFU or RAM file cannot be OPENed)) 

,<Data too large for buffers)) 

,<Input error or not all data read)) 

,<Argument block too small)) 

,<Invalid software interrupt channel number)) 

<Illegal to save files on this device)) 

,<Device does not have Direct Access (programmable) VFU); 

,<VFU or Translation Ram file must be on disk)) 

,<Invalid unit number)) 

,<WHEEL or OPERATOR capability required)) 

,<I.llegal to load RAM or VFU while device is OPEN)) 

,<Device is not on line)) 

, <No more job slots available for logging-in>) 

<Invalid operation for this device)) 
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ERR ( 


1341, 


ACESX1, 


ERR ( 


1342 


ACESX2, 


ERR 


1343 


DSKOX1, 


ERR 


1344 


DSKOX2, 


ERR 


1345 


MSTRX1, 


ERR 


1346 


MSTRX2, 


ERR 


1347 


MSTRX3, 


ERR 


1350 


MSTRX4, 


ERR 


1351 


MSTRX5, 


ERR ( 


1352, 


MSTRX6, 


ERR 


1353 


MSTRX7, 


ERR ( 


1354, 


MSTRX8, 


ERR ( 


1355, 


MSTRX9, 


ERR ( 


1356, 


MSTX10, 


ERR ( 


1357 


MSTX11, 


ERR 


1360, 


MSTX12, 


ERR ( 


1361 


MSTX13, 


ERR 


1362, 


MSTX14, 


ERR 


1363, 


MSTX15, 


ERR 


1364 


MSTX16, 


ERR 


1365 


DSKXOl, 


ERR 


1366 


DSKX02, 


ERR 


1367 


DSKX03, 


ERR 


1370 


DSKX04, 


ERR 


1371 


GFUSX1, 


ERR ( 


1372 


GFUSX2, 


ERR ( 


1373 


SFUSX1, 


ERR ( 


1374 


SFUSX2, 


ERR 


1375 


SFUSX3, 


ERR 


1376 


RCDIX1, 


ERR 


1377 


RCDIX2, 


ERR 


1400 


RCDIX3, 


ERR 


1401 


RCDIX4, 


ERR 


1402 


RCUSXl, 


ERR 


1403 


TDELX2, 


ERR 


1404 


TIMX5,< 


ERR 


1405 


LSTRXl, 


ERR 


1406 


SWJFXl, 


ERR 


1407 


MTOX18, 


ERR 


1410 


OPNX26, 


ERR 


1411 


DELFX9, 


ERR 


1412 


CRDIX6, 


ERR 


1413 


COMNX9, 


ERR 


1414 


STYPXl, 


ERR 


1415 


,PMAPX7, 


ERR 


1416 


DSKOX3, 


ERR 


1417 


P DESX10, 


ERR 


(1420 


,DSKOX4, 


ERR 


(1421 


,MSTX17, 


ERR 


(1422 


,MSTX18, 


ERR 


(1423 


,MSTX19, 


ERR 


1424 


MSTX20, 


ERR 


1425 


MSTX21, 


ERR 


1426 


MSTX22, 


ERR 


1427 


CRDI11, 


ERR 


1430 


MSTX23, 


ERR 


1431 


,ACESX3, 


ERR 


1432 


ACESX4, 


ERR 


1433 


,ACESX5, 


ERR 


1434 


r STRX05, 


ERR 


1435 


ACESX6, 


ERR 


1436 


STRX01, 


ERR 


1437 


STRX02, 



,<Argument block too small>) 

, insufficient system resources)) 

,<Channel number too large>) 

,<Unit number too large)) 

,<Invalid function)) 

,<WHEEL or OPERATOR capability required)) 

,<Argument block too small)) 

, <Insuff icient system resources)) 

,<Drive is not on-line)) 

,<Home blocks are bad)) 

,<Invalid structure name)) 

,<Could not get OFN for ROOT-DIRECTORY)) 

,<Could not MAP ROOT-DIRECTORY)) 

, <ROOT-DIRECTORY bad)) 

,<Could not initialize Index Table)) 

,<Could not OPEN Bit Table File)) 

,<Backup copy of ROOT-DIRECTORY is bad)) 

,<Invalid channel number)) 

,<Invalid unit number)) 

,<Invalid controller number)) 

,<Invalid structure number)) 

,<Bit table is being initialized)) 

,<Bit table has not been initialized)) 

,<Bit table being initialized by another job)) 

,<Invalid function)) 

, <Insuff icient system resources)) 

,<Invalid function)) 

, <Insuff icient system resources)) 

, <No such user name)) 

, <Insuff icient system resources)) 

,<Invalid directory specification)) 

,<Invalid structure name)) 

,< Monitor internal error)) 

, <Insuff icient system resources)) 

,<Invalid table entry location)) 

Invalid software interrupt channel number)) 
,<Process has not encountered any errors)) 
,<Illegal to swap same JFN>) 

,<Invalid software interrupt channel number)) 
,<Illegal to open a string pointer)) 
,<File is not a directory file)) 
,<Directory file is mapped)) 
,<End of input file reached)) 
,<Invalid terminal type)) 

,<Illegal to map file on dismounted structure)) 
,<Invalid structure number)) 
,<Structure is dismounted)) 
,<Invalid address type specified)) 

,<A11 units in a structure must be of the same type)) 
, <No more units in system)) 

,<Unit is already part of a mounted structure)) 
,<Data error reading HOME blocks)) 
,<Structure is not mounted)) 
,<Illegal to change specified bits)) 
,<Invalid terminating bracket on directory)) 
,<Could not write HOME blocks)) 
,<Password is required)) 

,<Function not allowed for another job)) 
,<No function specified for ACCES)) 
, <No such user name)) 
,<Directory is not accessed)) 
,<Structure is not mounted)) 
, <Insuf f i cient system resources)) 



B-88 



MONSYM 



ERR 


1440, 


ERR 


1441, 


ERR ( 


1442, 


ERR ( 


1443, 


ERR ( 


1444, 


ERR ( 


1445, 


ERR ( 


1446, 


ERR ( 


1447, 


ERR 


1450, 


ERR 


1451, 


ERR ( 


1452, 


ERR ( 


1453, 


ERR ( 


1454, 


ERR ( 


1455, 


ERR 


1456, 


ERR 


1457, 


ERR ( 


1460, 


ERR 


1461, 


ERR 


1462, 


ERR 


1463, 


ERR ( 


1464, 


ERR 


1465, 


ERR 


1466, 


ERR 


1467, 


ERR 


1470, 


ERR 


'1471, 


ERR 


(1472, 


ERR 


(1473, 


ERR 


1474, 


ERR 


1475, 


ERR 


(1476, 


ERR 


(1477, 


ERR 


1500, 


ERR 


(1501, 


ERR 


(1502, 


ERR 


(1503, 



10X11, <Quota exceeded>) 

10X12 , insufficient system resources (Swapping space full))) 

STRX03,<Nc such directory name)) 

STRX04 , <Ambiguous directory specif ication> ) 

PPNXl,<Invalid PPN>) 

PPNX2,<Structure is not mounted)) 

PPNX3 , insufficient system resources)) 

PPNX4 , <Invalid directory number)) 

SPLX6,<No directory to write spooled files into>) 

CRDI12, <St ructure is not mounted)) 

GFUSX3,<File expunged)) 

GFUSX4 , <Internal format of directory is incorrect)) 

RNMX13 , <Insuff icient system resources)) 

SJBX8 , <Illegal to perform this function)) 

DECRSV,<DEC reserved bits not zero)) 

FFFFXl,<No free pages in file)) 

WILDXl,<Second JFN cannot be wild)) 

MSTX41,<Channel does not exist)) 

MSTX42, Controller does not exist)) 

CIMXND, <Maximum memory driver nodes assigned)) 

CINOND,<No LCS node slots availble)) 

CIBDOF,<BAD BDT offset given >) 

CINOFQ,<No CI free queue entries left)) 

CINOPG,<No BDT page slots left)) 

CINPTH,<Target CI LCS node is dead, no path to it)) 

CIBDCD,<Bad CI op code)) 

CIUNOP, <Undef ined op code (in range but not yet defined)) 

CINOND,<Dead LCS node)) 

CILNER,<CI length error)) 

LCBDBP,<Bad byte pointer passed to LCS>) 

LCLNER,<LCS length error)) 

LCNOND,<LCS No such node)) 

SSAVX5, <Number of PDVs grew during save)) 

CIBDFQ,<BAD CI FREE QUEUE)) 

ATACX6 , <Terminal is already attached to a job)) 

ATACX7 ,<Illegal terminal number)) 



ERROR CODES 1504-1532 ARE AVAILABLE****** 



.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 
.ERR 

• ERR 
.ERR 
.ERR 
.ERR 

.ERR 

.ERR 

.ERR 

• ERR 



1533,DSKOX5,<Invalid word count)) 
1534,DSKOX6,<Invalid buffer address)) 
1535,TIMX6,<Time has already passed)) 
1536 ,TIMX7 ,<No space available for a clock)) 
1537 ,TIMX8 , <User clock allocation exceeded)) 
1540,TIMX9,<No such clock entry found)) 
1541,TIMXlO,<No system date and time)) 

1550,SCTXl,<Invalid function code)) 

1551 ,SCTX2, <Tei:minal already in use as controlling terminal)) 
1552,SCTX3,<Illegal to redefine the job's controlling terminal)) 
1553,SCTX4, <SC%SCT capability required)) 

1554 ,PDVX01 ,<Address in .POADE must be as large as address in 

.POADR)) 

1555 ,PDVX02 , <Addresses in . PODAT block must be in strict ascending 

order) ) 

1556 ,PDVX03 , <Address in .POADR must be a program data vector 

address) ) 

1557,GETX4,<Illegal to relocate (via .GBASE) a multi-section exe 

file)) 

1560 ,GETX5,<Exe file directory entry specifies a section-crossing) ; 



.ERR 

; Note: Error codes are available here! 
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ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
, ERR 
, ERR 
, ERR 
,ERR 
, ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 



(1700, 


(1701, 


(1702, 


(1703, 


(1704, 


(1705, 


(1706, 


(1707, 


(1711, 


(1712, 


(1713, 


(1714, 


(1715, 


(1716, 


(1717, 


(1720, 


(1721, 


(1722, 


(1723, 


(1724, 


(1725, 


(1726, 


(1727, 


(1730, 


(1731, 


(1732, 


(1733, 


(1734, 


(1735, 


(1736, 


(1737, 


(1740, 


(1741, 


(1742, 


(1743, 


(1744, 


(1745, 


(1746, 


(1747, 


(1750, 


(1751, 


(1752, 


(1753, 


(1754, 


(1755, 


(1756, 


(1757, 


(1760, 


(1761, 


(1763, 


(1764, 


(1765, 


(1766, 


(1767, 


(1770, 


(1771, 


(1772, 


(1773, 


(1774, 


(1775, 


(1776, 


(1777, 


(2000, 



SFUSX4,<File expunged>) 

SFUSX5 , <Wr ite or owner access required>) 

SFUSX6,<No such user name)) 

GETX3 , <Illegal to overlay existing pages>) 

FILX01,<File is not open>) 

ARGX01,<Invalid password)) 

CAPX3,<WHEEL capability required)) 

CAPX4,<WHEEL or IPCF capability required)) 

CAPX6,<ENQ/DEQ capability required)) 

CAPX7 , <Conf idential Information Access Capability required)) 

ARGX02,<Invalid function)) 

ARGX03 , <Illegal to change specified bits)) 

ARGX04,<Argument block too small)) 

ARGX05 , <Argument block too long)) 

ARGX06 , <Inval id page number)) 

ARGX07,<Invalid job number)) 

ARGX08,<No such job)) 

ARGX09,<Invalid byte size)) 

ARGX10 , <Invalid access requested)) 

ARGX11 , <Invalid directory number)) 

ARGX12, <Invalid process handle)) 

ARGX13 , <Invalid software interrupt channel number)) 

MONX01 , <Insuf f icient system resources)) 

MONX02,<Insuf f icient system resources (JSB full))) 

MONX03 , <Monitor internal error)) 

MONX04 , <Insuff icient system resources (Swapping space full))) 

ARGX14 , <Inval id account identifier)) 

ARGXl5,<Job is not logged in)) 

FILX02 , <Wr ite or owner access required)) 

FILX03,<List access required)) 

DEVX4 , <Device is not assignable)) 

FILX04,<File is not on multiple-directory device)) 

ARGX16 , <Password is required)) 

ARGX17 , <Inval id argument block length)) 

ARGX18 , <Inval id structure name)) 

DEVX5,<No such device)) 

DIRX4 , <Inval id directory specification)) 

FILX05,<File expunged)) 

STRX06,<No such user number)) 

MSTX24 ,<Illegal to dismount the System Structure)) 

MSTX25 , <Invalid number of swapping pages)) 

MSTX26 , <Invalid number of Front-End-Filesystem pages)) 

LOUTX5,<Illeqal to ] og out job 0>) 

GJFX43,<More than one ;T specification is not allowed)) 

MTOX19 ,<Invalid terminal page width)) 

MTOX20,<Invalid terminal page length)) 

MSTX27,<Specif ied unit is not a disk)) 

MSTX28,<Could not initialize bit table for structure)) 

MSTX29,<Could not reconstruct ROOT-DIRECTORY)) 

DSKX05,<Disk assignments and deassignments are currently prohibited) 

DSKX06,<Invalid disk address)) 

DSKX07 , <Address cannot be deassigned because it is not assigned)) 

DSKX08 , <Address cannot be assigned because it is already assigned)) 

COMXl0,<Invalid default string)) 

MSTX30 , <Incor rect Bit Table counts on structure)) 

LOCKX1 , <Illegal to lock other than a private page)) 

LOCKX2 , <Requested page unavailable)) 

LOCKX3 , <At tempt to lock too much memory)) 

ILLX01 , <Illegal memory read)) 

ILLX02 , <I1 legal memory write)) 

ILLX03 , <Memory data parity error >) 

ILLX04 , <Ref erence to non-existent page)) 

MSTX31,<Structure already mounted)) 
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ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 

ERR 
ERR 
ERR 
ERR 

ERR 

ERR 

ERR 

ERR 

ERR 

, ERR 

ERR 

ERR 

ERR 

, ERR 

, ERR 

, ERR 

, ERR 



(2001 
(2002 
(2003 
(2004 
(2005 
(2006 
(2007 
(2010 
(2011 
(2012 
(2013 
(2014 
(2015 
(2016 
(2017 
(2020 
(2021 
(2022 
(2023 
(2024 
(2025 
(2026 
(2027 
(2030 
(2031 
(2032 
(2033 
(2035 
(2036 
(2037 
(2040 
(2041 
(2042 
(2043 
(2044 
(2045 
(2046 
(2047 
(2050 
(2051 
(2052 
(2053 
(2054 

end> 
(2055 
(2056 
(2057 
(2060 

attr 
(2061 
(2062 
(2063 
(2064 
(2065 
(2077 
(2100 
(2101 
(2102 
(2103 
(2104 
(2105 

clos 
(2106 



MSTX32,<S1:ructure was not mounted>) 

MSTX33 , <Structure is unavailable for mounting>) 

STDIXl,<The STDIR JSYS has been replaced by PCDIR and RCUSR>) 

CNDIX7,<The CNDIR JSYS has been replaced by ACCES>) 

PMCLX1 , <IIlegal page state or state transition>) 

PMCLX2 , <Requested physical page is unavailable> ) 

PMCLX3 , <Requested physical page contains errors)) 

DLFX10 ,<Cannot delete directory; file still mapped>) 

DLFX11 ,<Cannot delete directory file in this manner)) 

GJFX44 ,<Account string does not match)) 

UTSTXl,<Invalid function code>) 

UTSTX2,<Ai:ea of code too large to test>) 

UTSTX3, <UTEST facility in use by another process)) 

BOTX01,<Invalid DTE-20 number)) 

BOTX02,<Invalid byte size)) 

DCNX1, <Invalid network file name)) 

DCNX5,<No more logical links available)) 

DCNX3,<Invalid object)) 

DCNX4,<Invalid task name)) 

DCNX9,<Object is already defined)) 

DCNX8 , <Invalid network operation)) 

DCNXll,<Link aborted)) 

DCNX12,<String exceeds 16 bytes)) 

TTYX01,<Line is not active)) 

BOTX03 , <Invalid protocol version number)) 

MONX05 , <Insuf f icient system resources (no resident free space)) 

ARGX19, <Invalid unit number)) 

COMXll,<Invalid CMRTY pointer)) 

COMX12,<Invalid CMBFP pointer)) 

COMX13, <Invalid CMPTR pointer)) 

COMXl4,<Invalid CMABP pointer)) 

COMX15,<Invalid default string pointer)) 

COMX16 , <Invalid help message pointer)) 

COMX17 , <Invalid byte pointer in function block)) 

NPXAMB,<Ambiguous~>) 

NPXNSW,<Not a switch - does not begin with slash)) 

NPXNOM,<Does not match switch or keyword)) 

NPXNUL, <Null switch or keyword given)) 

NPXINW,<Invalid guide word)) 

NPXNC,<Not confirmed)) 



NPXICN 
NPXIDT 
NPXNQS 

NPXNMT 
NPXNMD 
NPXCMA 
GJFX45 

ibute)) 
GJFX46 
GJFX47 
MSTX34 
GJFX48 
GJFX49 
SJBX7,< 
DELF10 
CRDI13 
CRDI14 
CRDI15 
CRDI16 
ENACX1 

ed>) 

,ENACX2, 



<Invalid character in number)) 

<Invalid device terminator)) 

<Not a quoted string - quote missing at beginning or 

<Does not match token)) 

<Does not match directory or user name)) 

<Comma not given)) 

<Illegal to request multiple specifications for the same 

<Attribute value is required)) 

<Attribute does not take a value)) 

<Unit is wr ite-locked) ) 

<GTJFN input buffer is empty)) 

<Invalid attribute for this device)) 

Remark exceeds 39 characters)) 

<Directory still contains subdirectory)) 

<Request exceeds superior directory working quota)) 

<Request exceeds superior directory permanent quota)) 

<Request exceeds superior directory subdirectory quota)) 

<Invalid user group)) 

<Account validation data base file not completely 

<Cannot get a JFN for <SYSTEM)ACCOUNTS-TABLE . BIN) ) 
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ERR 


2107 


ENACX3, 


ERR 


2110 


ENACX4, 


ERR 


2111 


VACCXO, 


ERR 


2112 


VACCXl, 


ERR 


2113 


USGX01, 


ERR 


2114 


BOTX04, 


ERR 


2115 


NODX01, 


ERR 


2116 


USGX02, 


ERR 


2117 


CRDI17, 




files 


3-only d 


ERR 


2120 


ENQX23, 


ERR 


2121 


ENQX22, 


ERR 


2122 


DCNX2,< 


ERR 


2123 


ABRKX1, 


ERR 


2124 


USGX03, 


ERR 


2125 


IPCF35, 


ERR 


2126 


VACCX2, 


ERR 


2127 


CRDI18, 


ERR 


2130 


CRDI19, 


ERR 


2132 


BOTX05, 


ERR 


2133 


CRDI20, 


ERR 


2134 


COMX18, 


ERR 


2135 


COMX19, 


ERR 


2136 


CRDI21, 


ERR 


2137 


ACESX7, 


ERR 


2140 


CRDI22, 




subd] 


Lrector i 


ERR 


2141 


CRDI23, 


ERR 


2142 


r STRX07, 


ERR 


2143 


STRX08, 


ERR 


2144 


CRDI24, 


ERR 


2146 


ATSX01, 


ERR 


2147 


ATSX02, 


ERR 


2150 


,ATSX03, 


ERR 


2151 


ATSX04, 


ERR 


2152 


ATSX05, 


ERR 


2153 


ATSX06, 


ERR 


2154 


r ATSX07, 


ERR 


2155 


r ATSX08, 


ERR 


2156 


ATSX09, 


ERR 


2157 


P ATSX10, 




assic 


jned) ) 


ERR 


2160" 


ATSXll, 


ERR 


2161 


r ATSXl2, 


ERR 


2162 


ATSX13, 


err 


2163 


ATSX14, 


ERR 


2164 


r ATSXl5, 


ERR 


2165 


PMCLX4, 


ERR 


2166 


ATSX16, 


ERR 


2167 


ATSX17, 


ERR 


2170 


FRKHX8, 


ERR 


2171 


ARGX20, 


ERR 


2172 


ARGX21, 


ERR 


2173 


ARGX22, 


ERR 


2174 


ATSX18, 


ERR 


2175 


ATSX19, 


ERR 


2176 


ATSX20, 


ERR 


2177 


ARGX23, 


ERR 


2200 


ARGX24, 


ERR 


2201 


MSTX35, 


ERR 


2202 


DCNX13, 


ERR 


2203 


DCNX14, 


ERR 


2204 


DCNX15, 



<Account validation data base file too 
<Cannot get an OFN for <SYSTEM>ACCOUNTS 
<Invalid account)) 

<Account string exceeds 39 characters)) 
<Invalid USAGE entry type code>) 
<Byte count is not positive)) 
<Node name exceeds 6 characters)) 
<Item not found in argument list)) 
<Illegal to create non-files-only subdi 
irectory) ) 

<Mismatched mask block lengths)) 
<Invalid mask block length)) 
Interrupt message must be read first)) 
<Address break not available on this sy 
<Default item not allowed)) 
<Invalid IPCF quota)) 
CAccount has expired)) 

<Illegal to delete logged-in directory) 
<Illegal to delete connected directory) 
<Protocol initialization failed)) 
<WHEEL, OPERATOR, or requested capabili 
<Invalid character in node name)) 
<Too many characters in node name)) 
<Working space insufficient for current 
<Directory is "files-only" and cannot b 
Subdirectory quota insufficient for ex 
.es>) 

<Superior directory does not exist)) 
<Invalid user number)) 
<Invalid user name)) 
<Invalid subdirectory quota)) 
<Invalid mode)) 

<Illegal to declare mode twice)) 
<Illegal to declare mode after acquirin 
<Invalid event code)) 

<Invalid function code for channel assi 
<JFN is not an ATS JFN>) 
<Table length too small)) 
<Table lengths must be the same)) 
<Table length too large)) 
<Maximum applications terminals for sys 



long)) 
-TABLE. BIN>) 



rectory under 



stem)) 



ty required)) 



allocation) ) 
e accessed)) 
ist ing 



g terminal)) 
gnment) ) 

tern already 



<Byte count is too large)) 

<Terminal not assigned to this JFN>) 

<Terminal is XOFF'd)) 

<Terminal has been released)) 

<Terminal identifier is not assigned)) 

<No more error information)) 

<Invalid Host Terminal Number)) 

<Output failed -- monitor internal error)) 

<Illegal to manipulate an execute-only process)) 

<Invalid arithmetic trap argument)) 

<Invalid LUUO trap argument)) 

<Invalid flags)) 

<ATS input message too long for internal buffers)) 

<Monitor internal error - ATS input message truncated)) 

<Illegal to close JFN with terminal assigned)) 

<Invalid section number)) 

<Invalid count)) 

<Too many units in structure)) 

<Node not accessible)) 

<Previous interrupt message outstanding)) 

<No interrupt message available)) 
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ERR 
ERR 
ERR 
ERR 
ERR 
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ERR 
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(2205 
(2206 
(2207 
(2210 
(2211 
(2212 
(2213 
assig 
(2214 
(2215 
(2216 
(2217 
(2220 
(2221 
(2222 
(2223 
(2224 
(2225 
(2226 
(2227 
(2230 
(2231 
(2232 
(2233 
(2234 
(2235 
(2236 
(2237 
(2240 
(2241 
(2242 
(2243 
(2244 
(2245 
(2246 
(2247 
(2250 
(2251 
(2252 
(2253 
(2254 
(2255 
(2256 
(2257 
(2260 
(2261 
(2262 
(2263 
(2264 
(2265 
(2266 
(2267 
(2270 
(2271 
(2272 
(2273 
(2274 
(2275 
(2276 
(2277 
(2300 
(2301 
(2302 



,GJFX50, 
,KDPX01, 
,NODX02, 
,NODX03, 
,GJFX51, 
,COMX20, 
f ATSX21, 
ned>) 
,ATSX22, 
,ATSX23, 
,ATSX24, 
,ATSX25, 
,GOKERl, 
,GOKER2, 
, STRX09, 
,MSTX36, 
,MSTX37, 
,MSTX40, 
, ATSX26, 
,10X13, < 
,10X14, < 
,10X15, < 
,10X16, < 
,10X17, < 
,10X20, < 
,10X21, < 
,10X22, < 
,10X23, < 
,10X24, < 
,10X25, < 
,SWJFX2, 
,10X26, < 
,10X27, < 
,10X30, < 
,ARGX25, 
,SKDX1,< 
,MREQX1 
, MREQX2 
, MREQX3 
,MREQX4 
,MREQX5 
, MREQX6 
, MREQX7 
,MREQX8 
,MREQX9 
,MREQ10 
,MREQ11 
,MREQ12 
,MREQ13 
,MREQ14 
,MREQ15 
,MREQ16 
,MREQ17 
,MREQ18 
, MREQ19 
,MREQ20 
,MREQ21 
,DEVX6,< 
,ATSX27 
,ATSX28 
,ATSX29 
,ATSX30 
,ATSX31 



< Invalid argument for attributed 

<KMC11 not running)) 

<Line not turned off>) 

<A:nother line already looped>) 

<Byte count too small)) 

<Invalid node name>) 

<Maximum applications terminals for job already 



<Failed to acquire applications terminal>) 

<Invalid device name)) 

<Invalid server name>) 

<Terminal is already released>) 

<Illegal function>) 

<Request denied by Access Control Facility>) 

<Prior structure mount required>) 

<Illegal while JFNs assigned>) 

<Illegal while connected to structure)) 

<Invalid PSI channel number given>) 

<Invalid host name)) 

Invalid segment type>) 

Invalid segment size>) 

Illegal tape format for dump mode>) 

Density specified does not match tape density)) 

Invalid tape label)) 

Illegal tape record size)) 

Tape HDR1 missing)) 

Invalid tape HDR1 sequence number)) 

Tape label read error)) 

Logical end of tape encountered)) 

Invalid tape format)) 

<Illegal to swap ATS JFN>) 

Tape write date has not expired)) 

Tape is domestic and HDR2 is missing)) 

Tape has invalid access character)) 

<Invalid class)) 

Cannot change class)) 
,<Request canceled by user)) 

,<Labeled tapes not permitted on 7-track drives)) 
,<Unknown density specified)) 
,<Unknown drive type specified)) 
,<Unknown label type specified)) 
,<Set name illegal or not specified)) 
,<Illegal starting-volume specification)) 
,<Attempt to switch to volume outside set)) 
,<Illegal volume identifier specified)) 
,<E>ensity mismatch between request and volume)) 
,<E>rive type mismatch between request and volume)) 
, <Label type mismatch between request and volume)) 
,<Structural error in mount message)) 
,<Setname mismatch between request and volume)) 
,<N'ount refused by operator)) 

,<Volume identifiers not supplied by operator)) 
, <Volume-identif ier list missing)) 

,<End of volume-identifier list reached while reading)) 
,<F:equested tape drive type not available to system)) 
,<Structural error in mount entry)) 
, <Mount requested for unknown device type)) 

Job has open JFN on device)) 
, <Terminal is not open)) 
,<Unknown error received)) 
,<Receive error threshold exceeded)) 
,<Reply threshold exceeded)) 
, <NAK threshold exceeded)) 
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, ERR 
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ERR 

, ERR 

,ERR 

ERR 

, ERR 

, ERR 

ERR 

, ERR 

ERR 

ERR 

ERR 

ERR 

,ERR 

ERR 

ERR 

, ERR 

ERR 

, ERR 

.ERR 

, ERR 

ERR 

, ERR 

, ERR 

, ERR 

, ERR 

,ERR 

, ERR 

, ERR 

ERR 

ERR 

,ERR 

ERR 

ERR 

ERR 

ERR 
ERR 
ERR 
ERR 
ERR 
ERR 



(2303 
(2304 
(2305 
(2306 
(2307 
(2310 
(2311 
(2312 
(2313 

devi 
(2314 
(2315 
(2316 
(2317 
(2320 
(2321 
(2322 
(2323 
(2324 
(2325 
(2326 
(2327 
(2330 
(2331 
(2332 
(2333 
(2334 
(2335 
(2336 

proc 
(2337 
(2340 
(2341 
(2342 
(2343 
(2344 
(2345 
(2346 
(2347 
(2350 
(2351 
(2352 
(2353 
(2354 
(2355 
(2356 
(2357 
(2360 
(2361 
(2362 
(2363 
(2364 
(2365 
(2366 
(2367 
(2370 

pass 
(2371 
(2372 
(2373 
(2374 
(2375 
(2376 



,ATSX32 

,ATSX33 

,ATSX34 

,ATSX35 

,ATSX36 

,DATEX7 

,MREQ22 

,ARCFX2 

,ARCFX3 

ces> ) 

,ARCFX4 

,ARCFX5 

,ARCFX6 

,ARCFX7 

,ARCFX8 

,ARCFX9 

,ARCX10 

f ARCX11 

,ARCX12 

,ARCX13 

,OPNX30 

,OPNX31 

f DELX11 

,DELX12 

,ARCX14 

,ARCX15 

,ARCX16 

,ARCX17 

,ARCX18 

ess>) 

,ARCX19 

, ARGX26 

,ARGX27 

,DIRX5,( 

, 10X31, < 

,MREQ23, 

,MREQ24, 

,MREQ25, 

,LTLBLX, 

, LTLBX1, 

,MREQ26, 

,METRXl, 

,NSPX00, 

,NSPX01, 

,NSPX02, 

,NSPX03, 

,NSPX04, 

,NSPX05, 

,NSPX06, 

,NSPX07, 

,NSPX08, 

,NSPX09, 

,NSPX10, 

,NSPX11, 

,NSPX12, 

,NSPX13, 

word) ) 

,NSPX14, 

,NSPX15, 

,NSPX16, 

,NSPX17, 

,NSPX18 , 

,NSPX19, 



(Terminal protocol error)) 

(Intervention required at terminal)) 

<Powerf ail>) 

<Data pipe was disconnected)) 

<Dialup terminal was attached)) 

<Julian day is out of range)) 

<Structure name not specified)) 

<File already has archive status)) 

<Cannot perform ARCF functions on non-multiple directory 

<File is not on-line)) 

<Files not on the same device or structure)) 

<File does not have archive status)) 

<Invalid parameter)) 

<Archive not complete)) 

<File not off-line)) 

<Archive prohibited)) 

<Archive requested, modification prohibited)) 

<Archive requested, delete prohibited)) 

<Archive system request not completed)) 

<File has archive status, modification is prohibited)) 

<File is off-line)) 

<File has archive status, delete is not permitted)) 

<File has no pointer to offline storage)) 

<File restore failed)) 

<Migration prohibited)) 

<Cannot exempt offline file)) 

<FDB incorrect format for ARCF JSYS>) 

<Retrieval request cannot be fulfilled for waiting 



<Migration al 
<File is offl 
<Offline expi 
Directory too 
Invalid recor 
<Dismount ref 
<Illegal to d 
<Structure no 
<Too many use 
<Undefined re 
<Tape mountin 
<METER% not s 
<Connection n 
(Resource all 
<Dest inat ion 
<Node shuttin 
(Destination 
(Invalid proc 
(Destination 
(Unspecified 
(Connection a 
(Link aborted 
(NSP Failure 
(Too many con 
(Too many con 
(Access denie 



ready pending)) 

ine) ) 

ration time cannot exceed system maximum)) 

large) ) 
d descriptor in labeled tape)) 
used by operator)) 
ismount connected structure)) 
t found)) 
r labels)) 

cord format on non-TOPS20 tape)) 
g function disabled by installation)) 
upported on this processor)) 
ot accepted)) 
ocation failure)) 
node does not exist)) 
g down)) 

process does not exist)) 
ess name)) 

process queue overflow)) 
error) ) 
borted by third party)) 

by process)) 
- Flow control violation)) 
nections to node)) 
nections to destination process)) 
d due to unacceptable user name or 



(NSP failure - invalid SERVICES field)) 

(Invalid account)) 

(NSP failure - invalid SEGSIZ field)) 

(Process aborted, timed out, or cancelled request)) 

(No path to destination node)) 

(NSP failure - flow control failure)) 



B-94 



MONSYM 



, ERR 
.ERR 
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, ERR 
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ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 

ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
ERR 
, ERR 
, ERR 



(2377 
(2400 
(2401 
(2402 
(2403 
(2404 
(2405 
(2406 
(2407 
(2410 
(2411 
(2412 
(2413 
(2414 
(2415 
(2416 
(2417 
(2420 
(2421 
(2422 
(2423 
(2424 
(2425 
(2426 
(2427 
(2430 
(2431 
(2432 
(2433 

space 
(2434 
(2435 
(2436 
(2437 
(2440 
(2441 
(2442 
(2443 
(2444 
(2445 
(2446 
(2447 
(2450 
(2451 
(2452 
(2453 
(2454 
(2455 
(2456 
(2457 
(2460 
(2461 

chara 
(2462 
(2463 
(2464 
(2465 
(2466 
(2467 
(2470 
(2471 
(2472 
(2473 



,NSPX20 
,NSPX21 
,NSPX22 
,MREQ27 
,MREQ28 
,MREQ29 
,MREQ30 
,DIAG11 
,DIAG12 
,DESX11 
,NSPX23 
,ARGX28 
,NPX2CL 
,ARGX29 
, ARGX30 
,ARGX31 
,DEVX7 f 
,GJFX52 
,GOKER3 
,10X32, 
,10X33, 
,XSIRX1 
,SIRX2, 
,RIRX1, 
,XSIRX2 
,MREQ31 
,SMAPX1 
,TTMSX1 
,MONX06 

>) 
,BOTX06 
,BOTX07 
,BOTX08 
,BOTX09 
,BOTX10 
, BOTX11 
,B0TX12 
,B0TX13 
,B0TX14 
,B0TX15 
,B0TX16 
,B0TX17 
,B0TX18 
,NTMX1, 
,COMX21 
,DELX13 
,ANTX01 
,TTYX02 
,NSPX24 
,NSPX25 
,NSPX26 
,GJFX53 
cters) 
,10X34, 
,10X35, 
,PMAPX8 
, SMAPX2 
,GJFX54 
,B0TX19 
,BOTX20 
, ILLX05 
, XSEVX1 
,XSEVX2 



,<NSP failure - invalid DSTADDR 
,<Disconnect conf irmation>) 
,<NSP failure - image data fiel 
,<Structure is set IGNORED>) 
,<Cannot overwrite volume - fir 
,<Cannot overwrite volume - wri 
,<Tape label format error)) 
,<Unit already online>) 
,<Unit not online>) 
,<Invalid operation for this la 
,<Invalid NSP reason code>) 
,<not available on this system> 
,<Two colons required on node n 
,<Invalid class share)) 
,<Invalid KNOB value)) 
,<CIass Scheduler already enabl 
<Null device name given)) 
,<End of tape encountered while 
,<JSYS not executed within ACJ 
<Tape position is indeterminate 
<TTY input buffer full)) 
,<Channel table crosses section 
<SI.'R JSYS invoked from non-zero 
<RIR JSYS incompatible with pre 
<Level table crosses section b 
<I:nsuf f icient MOUNTR resources 
<Attempt to delete a section s 
<Could not send message within 
insufficient system resources 



>) 

d too long)) 

st file is not expired)) 
te access required)) 



bel type)) 



) 
ame) ) 



ed>) 

searching for file)) 
fork)) 
>) 

boundary) ) 

section) ) 
vious XSIR>) 
oundary) ) 
>) 
till shared)) 

timeout interval)) 

(No swappable free 



<GTJFN failed for dump file)) 

<OPENF failed for dump file)) 

<Dump failed)) 

<To -10 error on dump)) 

<To -11 error on dump)) 

<Failed to assign page on dump)) 

<Reload failed)) 

<-ll didn't power down)) 

<-ll didn't power up)) 

<ROM did not ACK the -10>) 

<-ll boot program did not make it to -ID) 

<-ll took more than 1 minute to reload. Will cause retry) 

<Unknown BOOT error)) 
<Network Management unable to complete request)) 

<Node name doesn't contain an alphabetic character)) 

<File is marked "Never Delete")) 

<Mo more network terminals available)) 

<Illegal character specified)) 

<Node name not assigned to a network node)) 

<311egal DECnet node number)) 

<Table of topology watchers is full)) 

<Tape label filename specification exceeds 17 
) 

<Disk structure completely full)) 
<Disk structure damaged, cannot allocate space)) 
,<l'ndirect page map loop detected)) 
,<Indirect section map loop detected)) 
,<Node name not first field)) 
,<Overdue TO- 11 transfer aborted)) 
,<Overdue T0-10 transfer aborted)) 

,<Illegal memory reference, section greater than 37>) 
,<'[llegal entry vector type)) 
,<Invalid entry vector length)) 
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.ERR (2474 , XSEVX3 , <Cannot get extended values with this monitor call>) 
> ;END OF . ERCOD DEFINITION 

; DEFINE THE ERROR CODE VALUES 

DEFINE .ERR (N,E,S) < 
E==: .ERBAS+N 
IFG <N-.ERMAX>,<.ERMAX==:N>> 

.ERMAX==:0 

.ERCOD 
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;THIS SECTION CONSISTS OF SPECIAL CODE TO WRITE THE EPRMES.BIN FILE 
; THE CODE IS ONLY ASSEMBLED IF .EPBLD IS PREVIOUSLY 
; DEFINED TO BE NON-ZERO. 

IFNDEF .ERBLD,<.ERBLD==0> 

IFN .ERBLD,< 



.ERGO: 



.ERER: 



MOVSI 1, (GJ%FOU!GJ%SHT) ;GET A JFN ON ERROR FILE 

HRROI 2, [ASCIZ/ERRMES.BIN/] 

GTJFN 

JRST .ERER 
MOVE 2, [440000, ,OF%WRl 
OPENF 

JRST .ERER 
MOVNI 3, .ERSTE-.ERTAB 
MOVE 2, [POINT 36,.ERTAB] 
SOUT 
CLOSF 

JRST .ERER 
HALTF 



MOVE I 1,101 
HRLOI 2,400000 
SETZ 3, 
ERSTR 

JFCL 

JFCL 
HALTF 



OPEN THE FILE FOR WRITE 

GET LENGTH OF FILE 

OUTPUT THE ERROR FILE DATA 
CLOSE THE FILE 

DONE 

TYPE OUT ERROR CODE 



LIT 

DEFINE .ERR (N,E,S) < 

. ERQQ= = < . -- . ERTAB> *5 

.ERQQ2==N*<37777 

.ERRM1 \.ERQQ2,N, .ERQQ 

ASCII \S'@\ 
> 

DEFINE .ERRM1 (NN , N , . ERQQ) < 
IF1,<IFDEF EZ'NN,< 

PRINTX ERROR N=NN HAS ALREADY BEEN USED 
>> 

EZ 'NN==1 
RELOC .ERTAB+NN 

.ERQQ 
RELOC 



.ERTAB: . ERMAX 



.ERST: 
.ERSTE 



BLOCK .ERMAX 
.ERCOD 

END .ERGO 



PURGE .ERR,REL 

END 
;D$ 



; FIRST WORD OF TABLE IS THE LENGTH 
; OF THE TABLE FOR ERSTR TO USE AS 
; A BOUNDS CHECK. 
; LEAVE ROOM FOR POINTERS 

; BUILD STRINGS AND .ERTAB 
;END OF STRINGS 



;END OF IFN . ERBLD CONDITIONAL 
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; UPD ID= 82, <5 . UTILITIES>MACSYM .MAC . 4 3 , 22-Feb-82 17:57:38 by MURPHY 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED 
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE. 

COPYRIGHT (C) 1976,1977,1978,1979,1980,1981 BY DIGITAL EQUIPMENT CORPORATION, 
MAYNARD, MASS. 



;VERSION 1 

IFNDEF REL,<REL==0> 
IFE REL,< 

UNIVERSAL MACSYM 
> 
IFN REL,< 

TITLE MACREL 

SEARCH MONSYM 

SALL 
> 



; UNIVERSAL UNLESS OTHERWISE DECLARED 
COMMON MACROS AND SYMBOLS 

SUPPORT CODE FOR MACSYM 



THE STANDARD VERSION WORD CONSTRUCTION 
VERS - PROGRAM VERSION NUMBER 

VUPDAT - PROGRAM UPDATE NUMBER (1=A, 2=B ...) 
VEDIT - PROGRAM EDIT NUMBER 
VCUST - CUSTOMER EDIT CODE (0=DEC DEVELOPMENT, 1=DEC SWS , 2-7 CUST) 



DEFINE PGVER. 



(VERS, VUPDAT, VEDIT, VCUST) < 



. .PGV0==. 

. JBVER=:~0137 

LOC .JBVER 

BYTE 

.ORG 



SAVE CURRECT LOCATION AND MODE 
WHERE TO PUT VERSION 
PUT VERSION IN STANDARD PLACE 
(3) VCUST (9) VERS ( 6 ) VUPDAT ( 1 8 ) VEDIT 
. .PGVO ;; RESTORE LOCATION AND MODE 



; MASKS FOR THE ABOVE 



VI%WHO== 
VI%MAJ== 
VI%MIN== 
VI%EDN== 



7B2 

777B11 
77B17 
777777B35 



; ADDED VI%XXX 



.-Customer edit code 
;Major version number 
;Minor version/update 
;Edit number 
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SUBTTL COMMON DEFS 



; DEFINE STANDARD AC'S 



DEF 
F=: 
Tl = 
T2 = 
T3 = 
T4 = 

Ql = 
Q2= 
Q3 = 
Pl = 
P2= 
P3 = 
P4 = 
P5= 
P6 = 
CX= 
P=: 
> 



INE STDAC. < 



:1 

:2 

:3 

:4 

:5 

:6 

:7 

:10 

:11 

:12 

:13 

:14 

:15 

:16 

17 



SUBTTL MISC CONSTANTS 



;MISC CONSTANTS 



.INFIN== 
.MINFI== 
.LHALF== 
.RHALF== 



.FWORD==:-l 



377777, ,777777 
1B0 

777777B17 
777777 



PLUS INFINITY 
MINUS INFINITY 
LEFT HALF 
RIGHT HALF 
FULL WORD 
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SUBTTL 


CHNUL== 


000 


CHCNA== 


001 


CHCNB== 


002 


CHCNC== 


003 


CHCND== 


:004 


CHCNE== 


005 


CHCNF== 


006 


CHBEL== 


007 


CHBSP== 


010 


CHTAB== 


Oil 


CHLFD== 


012 


CHVTB== 


013 


CHFFD== 


014 


CHCRT== 


015 


CHCNN== 


016 


CHCNO== 


017 


CHCNP== 


020 


CHCNQ== 


021 


CHCNR== 


022 


CHCNS== 


023 


CHCNT== 


024 


CHCNU== 


025 


CHCNV== 


026 


CHCNW== 


027 


CHCNX== 


030 


CHCNY== 


031 


CHCNZ== 


032 


CHESC== 


033 


CHCBS== 


034 


CHCRB== 


035 


CHCCF== 


036 


CHCUN== 


037 


CHSPC== 


040 


CHALT== 


175 


CHAL2== 


176 


CHDEL== 


177 



SYMBOLS FOR THE CONTROL CHARACTERS 
;NULL 



BELL 

BACKSPACE 

TAB 

LINE-FEED 

VERTICAL TAB 

FORM FEED 

CARRIAGE RETURN 



ESCAPE 

CONTROL BACK SLASH 

CONTROL RIGHT BRACKET 

CONTROL CIRCUMFLEX 

CONTROL UNDERLINE 

SPACE 

OLD ALTMODE 
ALTERNATE OLD ALTMODE 
DELETE 
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SUBTTL HARDWARE BITS OF INTEREST TO USERS 



;PC FLAGS 


PC%OVF== 


1B0 


PC%CY0== 


1B1 


PC%CY1== 


1B2 


PC%FOV== 


1B3 


PC%BIS== 


1B4 


PC%USR== 


1B5 


PC%UIO== 


1B6 


PC%LIP== 


1B7 


PC%AFI== 


1B8 


PC%ATN== 


3B10 


PC%FUF== 


1B11 


PC%NDV== 


1B12 



OVERFLOW 

CARRY 

CARRY 1 

FLOATING OVERFLOW 

BYTE INCREMENT SUPPRESSION 

USER MODE 

USER IOT MODE 

LAST INSTRUCTION PUBLIC 

ADDRESS FAILURE INHIBIT 

APR TRAP NUMBER 

FLOATING UNDERFLOW 

NO DIVIDE 
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;THE FOLLOWING MACRO MAY BE USED TO SUPPRESS CREF ENTRIES FOR 
;ALL THE JUNK SYMBOLS USED INTERNALLY WITHIN MACROS IN MACSYM 

DEFINE .XCMSY < 
.XCREF 

.XCRF1 <. .ACT, . .CSC, . .CSN, . . IFT, . .JXl, . .MSK, . .MXl, . .MX2> 
.XCRF1 <. .NAC, . .NRGS, . .NS, . .NV, . .PST, . .STKN, . .STKQ, . . STKR> 
.XCRF1 <. .TRR, . .TSA1 , . . TX1 , . . TX2 , . FP , . FPAC , .NAC, .SAC, .SAV1> 
•XCRF1 <.SAV2, .SAV3,POINTR,POS,WID, . .CAS1, . . CNS , . .CNS2> 
.XCRF1 <. .DPB, . .GNCS, . .ICNS, . .JE, . . LDB , . .STRO, . . STRl , . .STR2> 
.XCRF1 <. .STR4, . .TQO, . .TQZ , . .TSAC, . . TSIZ , . . TX , . . TY , .ACVl, .ACV2> 
.XCRF1 <.ACV3, .CASE, .DECRO, .IFO, . INCRO , .OPST1, .OPST2, .STKV1> 
. XCRF1 < . STKV2 , . STKV3 , . TRV1 , . TRV2 , . TRV3> 
.CREF 
> 

DEFINE .XCRF1 (SYMS)< 
IRP SYMS,< 
IFDEF SYMS,< .XCREF SYMS>>> 

SUBTTL MACROS FOR FIELD MASKS 

; STANDARD MACROS 

; MACROS TO HANDLE FIELD MASKS 

; COMPUTE LENGTH OF MASK, I.E. LENGTH OF LEFTMOST STRING OF ONES 
;REMEMBER THAT ~L DOES 'JFFO 1 , I.E. HAS VALUE OF FIRST ONE BIT IN WORD 

; COMPUTE WIDTH OF MASK, I.E. LENGTH OF LEFTMOST STRING OF ONES 

DEFINE WID(MASK) <<~L<-< <MASK>_<~L<MASK> >>-l> >> 

; COMPUTE POSITION OF MASK, I.E. BIT POSITION OF RIGHTMOST ONE IN MASK 

DEFINE POS(MASK) <<~ L< <MASK>& <-<MASK> >>>> 

; CONSTRUCT BYTE POINTER TO MASK 

DEFINE POINTR(LOC,MASK) <<POINT WID (MASK) , LOC , POS (MASK) >> 

;PUT RIGHT-JUSTIFIED VALUE INTO FIELD SPECIFIED BY MASK 

DEFINE FLD(VAL,MSK) < < <<VAL>B<POS (MSK) >>&<MSK>>> 

;MAKE VALUE BE RIGHT JUSTIFIED IN WORD. 

DEFINE .RTJST(VAL,MSK) < <<<VAL>& <MSK> >B< ~D7 0-POS (MSK) >>> 

;CONSTRUCT MASK FROM BIT AA TO BIT BB. I.E. MASKB 0,8 = 777B8 

DEFINE MASKB (AA,BB) <<1B< <AA>-1>-1B<BB> >> 

;MODULE - GIVES REMAINDER OF DEND DIVIDED BY DSOR 

DEFINE MOD. (DEND, DSOR) << <DEND>-< <DEND>/<DSOR> >* <DSOR> > > 
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; REPEAT WITH SUBSTITUTION OF NUMERIC INDEX 

DEFINE FORN. ( LOW , HIGH , ARGS , STRING , %MN1 ) < 

DEFINE %MN1 (ARGS) <STRING> 
. .FORN==LOW 
REPEAT HIGH-LOW+1, < 

.FORN1 (%MN1) 

. .FORN=. .FORN+l>> 

DEFINE .FORN1 (MACN) < 

MACN (\..FORN)> 

; REPEAT WITH GENERAL STRING SUBSTITUTION 

DEFINE FORX. (ARGS , SYMS , STRING , %MN1) < 
DEFINE %MN1 (SYMS) <STRING> 
IRP ARGS,< 

.FORX1 %MN1,ARGS>> 

DEFINE .FORX1 (MACN, ARGS) < 
MACN ARGS> 



C-7 



MACSYM 



SUBTTL MOVX 

;MOVX - LOAD AC WITH CONSTANT 

DEFINE MOVX (AC,MSK)< 
. .MX1==MSK 
. IFN . .MX1, ABSOLUTE, < 

MOVE AC, [MSK] > 
•IF . .MX1, ABSOLUTE, < 
. .MX2==0 

IFE <. .MX1>B53,< 
. .MX2==1 
MOVEI AC, . .MX1> 
IFE ..MX2,< 
IFE <. .MX1>B17,< 
. .MX2==1 

MOVSI AC, ( . .MX1) >> 
IFE ..MX2,< 
IFE <<. .MXl>B53-~0777777>,< 
. ,MX2==1 

HRROI AC,<..MX1>>> ;;LH -1 
IFE ..MX2,< ;;IF HAVEN'T DONE IT YET, 

IFE <<. .MX1>B17-~0777777B17>,< 
. .MX2==1 

HRLOI AC, ( . .MXl-~0777777) >> ;;RH -1 
IFE ..MX2,< ;;IF STILL HAVEN'T DONE IT, 

MOVE AC,f..MXl]> ;;GIVE UP AND USE LITERAL 
>> 

;MV., MVI . - Move from memory to memory or immediate to memory 



;;EVAL EXPRESSION IF ANY 



;;FLAG SAYS HAVEN'T DONE IT YET 



; ;LH 0, DO AS RH 

;;IF HAVEN'T DONE IT YET, 



; ;RH 0, DO AS LH 

;;IF HAVEN'T DONE IT YET, 



DEFINE MV. (FROM, TOO) < 
MOVE .SAC, FROM 
MOVEM .SAC,TOO> 

DEFINE MVI. (STUFF, DEST) < 
MOVX .SAC,<STUFF> 
MOVEM .SAC,DEST> 
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;VARIENT MNEMONICS FOR TX DEFINITIONS 

DEFINE IORX (AC,MSK)< 

TXO AC,<MSK>> 

DEFINE ANDX (AC,MSK)< 

TXZ AC,<~-<MSK>>> 

DEFINE XORX (AC,MSK)< 

TXC AC,<MSK>> 
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SUBTTL TX — TEST MASK 

; CREATE THE TX MACRO DEFINITIONS 

;THIS DOUBLE IRP CAUSES ALL COMBINATIONS OF MODIFICATION AND TESTING 
;TO BE DEFINED 

DEFINE . .DOTX (M,T) < 
IRP M,< 
IRP T,< 

DEFINE TX'M'T (AC,MSK)< 

. .TX(M'T,AC,<MSK>) >>>> 

..DOTX (<N,0,Z,O,<,E,N,A>) ; DO ALL DEFINITIONS 
PURGE ..DOTX 

; . .TX 

;ALL TX MACROS JUST CALL . . TX WHICH DOES ALL THE WORK 

DEFINE . .TX(MT,AC,MSK) < 

..TX1==MSK ;;EVAL EXPRESSION IF ANY 

. IFN . .TX1, ABSOLUTE, < 

TD'MT AC, [MSK] > 
.IF . .TX1, ABSOLUTE, < ;;MASK MUST BE TESTABLE 

..TX2==0 ;;FLAG SAYS HAVEN'T DONE IT YET 

IFE <. .TX1&"0777777B17>,< 

..TX2==1 r;LH 0, DO AS RH 

TR'MT AC, . .TX1> 
IFE ..TX2,< ;;IF HAVEN'T DONE IT YET, 

IFE <. .TX1&~0777777>,< 

..TX2==1 ;;PH 0, DO AS LH 

TL'MT AC, ( . .TX1) >> 
IFE ..TX2,< ;;IF HAVEN'T DONE IT YET, 

IFE <<. .TXl>B53-~0777777>,< ;;IF LH ALL ONES, 
. .TX3 (MT,AC)>> ; ;TRY Z,0,C SPECIAL CASES 
IFE ..TX2,< ;;IF HAVEN'T DONE IT YET, 

IFE <..TX1+1>,< ; ;TRY WORD ALL ONES 
. .TX4 (MT,AC) >> 
IFE ..TX2,< ;;IF STILL HAVEN'T DONE IT, 

TD'MT AC,[..TX1]> ;;MUST GIVE UP AND USE LITERAL 
>> 
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DEFINE ..TX3 (MT,AC)< 

IFIDN <MTXZ>,< 

. .TX2==1 

ANDI AC,"-. .TX1> 
IFIDN <MT><0>,< 

. .TX2==1 

ORCMI AC,"-. .TX1> 
IFIDN <MTXC>,< 

. .TX2==1 

EQVI AC,"-. .TX1>> 



;;IF ZEROING WANTED 

; ;CAN DO IT WITH ANDI 
;;IF SET TO ONES WANTED 

;;CAN DO IT WITH IORCM 
;;IF COMPLEMENT WANTED 

; ;CAN DO IT WITH EQV 



; SPECIAL CASE OF WORD ALL ONES 



DEFINE . .TX4 (MT,AC) < 

IFIDN <MTXNN>,< 
. .TX2==1 
CAIN AC,0> 
IFIDN <MTXNE>,< 
. .TX2==1 
CAIE AC,0>> 



;;CAN DO FULL WORD COMPARE 
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SUBTTL JX — JUMP ON MASK 



JXE — JUMP IF MASKED BITS ARE EQUAL TO 

JXN — JUMP IF MASKED BITS ARE NOT EQUAL TO 

JXO — JUMP IF MASKED BITS ARE ALL ONES 

JXF — JUMP IF MASKED BITS ARE NOT ALL ONES (FALSE; 



DEFINE JXE (AC,MSK,BA)< 

..JX1==MSK ;;EVAL EXPRESSION IF ANY 

. IFN . .JX1, ABSOLUTE, <PRINTX MSK NOT ABSOLUTE 

. .JX1==0> 
.IF . .JX1, ABSOLUTE, < 
• IFO <<. .JX1>-1B0>,< 

JUMPGE AC,BA>,< 
•IFO <<. .JX1>+1>,< 
JUMPE AC,BA>,< 

TXNN (AC, . . JX1) 

JRST BA>>>> 



; ;IF MASK IS JUST BO, 

;;IF MASK IF FULL WORD, 
;;USE GIVEN CONDITION 



DEFINE JXN (AC,MSK,BA)< 

..JX1==MSK ;;EVAL EXPRESSION IF 

.IFN . .JX1, ABSOLUTE, <PRINTX MSK NOT ABSOLUTE 

. .JX1==0> 
.IF . .JX1, ABSOLUTE, < 
.IFO <<. .JX1>-1B0>,< 

JUMPL AC,BA>,< 
•IFO <<. . JX1>+1> ,< 
JUMPN AC,BA>,< 

TXNE (AC,..JX1 

JRST BA>>>> 



ANY 



; ;IF MASK IS JUST BO, 

;;IF MASK IF FULL WORD, 
;;USE GIVEN CONDITION 
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DEFINE JXO (AC,MSK,BA) < 

. .JX1==MSK ;;EVAL EXPRESSION 

.IFN . .JX1, ABSOLUTE, <PRINTX MSK NOT ABSOLUTE 

. .. JX1 = = 0> 
.IF . .JXl,. ABSOLUTE, < 
.IFO <<. .JX1>-1B0>,< 

JUMPL AC,BA>,< 
..ONEB (..,BT,MSK) 
.IFO . .BT,< 

SETCM .SAC, AC 
JXE ( .SAC, . .JX1,BA) >,< 
TXNE AC, . .JX1 
JRST BA>>>> 



;TEST MASK FOR ONLY ONE BIT ON 

GENERAL CASE, GET COMPLEMENTS OF BITS 
;JUMP IF BITS WERE ORIGINALLY ONES 
TEST AND JUMP 



DEFINE JXF (AC,MSK,BA)< 

,.JX1==MSK ;;EVAL EXPRESSION 

.IFN . .JX1, ABSOLUTE, <PRINTX MSK NOT ABSOLUTE 

. „JX1==0> 
•IF . .JX1, ABSOLUTE, < 
.IFO <<• .JX1>-1B0>,< 

JUMPGE AC,BA>,< 
. .ONEB ( . .. BT,MSK) 
.IFO . .BT,< 

SETCM .SAC, AC 
JXN ( .SAC, . . JX1,BA) >,< 
TXNN AC, . .JX1 
JRST BA>>>> 



;TEST MASK FOR ONLY ONE BIT ON 

GENERAL CASE, GET COMPLEMENT OF BITS 
;JUMP IF SOME ZEROS ORIGINALLY 
TEST AND JUMP 
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SUBTTL SUBFUNCTION MACROS 

;.IF0 CONDITION, ACTION IF CONDITION 0, ACTION OTHERWISE 

DEFINE .IFO (COND, THEN, ELSE) < 

..IFT==COND ; ;GET LOCAL VALUE FOR CONDITION 

IFE ..IFT,< 

THEN 

. .IFT==0> ;, -RESTORE IN CASE CHANGED BY NESTED .IFO 

IFN ..IFT,< 

ELSE>> 

,-CASE (NUMBER, <FIRST, SECOND, . . . ,NTH>) 

DEFINE .CASE (NUM,LIST)< 
. .CSN==NUM 
. .CSC = = 
IRP LIST,< 
IFE . .CSN-. .CSC,< 
STOPI 

..CAS1 (LIST)> 
. .CSC==. .CSC+1>> 

DEFINE ..CAS1 (LIST)< 
LIST> 

;TEST FOR FULL WORD, RH, LH, OR ARBITRARY BYTE 

DEFINE . .TSIZ (SYM,MSK)< 

SYM==3 ;, -ASSUME BYTE UNLESS... 

IFE <MSK>+1 ,<SYM=0> ;;FULL WORD IF MASK IS -1 

IFE <MSK>-"0777777,<SYM==1> ;;RH IF MASK IS 777777 

IFE <MSK>-"0777777B17,<SYM= = 2>> ; ; LH IF MAST IS 777777,, 

,-TEST FOR LOC BEING AN AC -- SET SYM TO 1 IF AC, IF NOT AC 

DEFINE ..TSAC (SYM, LOC) < 



SYM==0 

. .TSA1 = = <Z LOO 

.IF . .TSA1 , ABSOLUTE, < 



ASSUME NOT AC UNLESS... 
LOOK AT LOC 

SEE IF WE CAN TEST VALUE 
IFE . .TSAl&"O777777777760,<SYM==l>> ;;AC IF VALUE IS 0-17 
> 



;TEST FOR SPECIFIC NTH CHARACTER OF APG 

DEFINE ..TSNC ( SYM ,NTH , STR , CH) < 

SYM==0 ; ;ASSUME NO 

. .TSA1 = = ;; COUNT CHARS 

IRPC STR,< 

. .TSA1=. .TSA1+1 
IFE ..TSA1-NTH,< 
IFIDN <STRXCH>,< 

SYM==1> ; ;YES 

STOPI>>> 

; FUNCTION TO TEST FOR MASK CONTAINING EXACTLY ONE BIT. RETURNS 
;1 IFF LEFTMOST BIT AND RIGHTMOST BIT ARE SAME 

DEFINE . .ONEB (SYM,MSK)< 

SYM==<<<-<MSK>>&<MSK>>&<1B<~L<MSK>>>>> 

; DEFAULT SCRACH AC 
.SAC=16 
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SUBTTL DEFSTR — DEFINE DATA STRUCTURE 

DEFINE DATA STRUCTURE 
NAM - NAME OF STRUCTURE AS USED IN CODE 
LOCN - ADDRESS OF DATA 

POS - POSITION OF DATA WITHIN WORD (RIGHTMOST BIT NUMBER) 
SIZ - SIZE OF DATA (IN BITS) WITHIN WORD 

DEFINE DEFSTR (NAM , LOCN, POS , SIZ ) < 

NAM==<-1B<P0S>+1B<P0S-SIZ>> ; ;ASSIGN SYMBOL TO HOLD MASK 

IF1,<IFDEF % 'NAM,<PRINTX ?NAM ALREADY DEFINED>> 

DEFINE %'NAM (OP , AC , Y , MSK ) < 

$'NAM==<Z LOCN> ;;LOCATION SYMBOL FOR DDT 

OP (<AC> , LOCN 1 'Y, MSK) >> ;;DEFINE MACRO TO HOLD LOCATION 

; ALTERNATE FORM OF DEFSTR -- TAKES MASK INSTEAD OF POS, SIZ 

DEFINE MSKSTR (NAM , LOCN , MASK) < 

NAM==MASK ;, -ASSIGN SYMBOL TO HOLD MASK 

IF1,<IFDEF % 'NAM,<PRINTX ?NAM ALREADY DEFINED>> 

DEFINE %'NAM (OP , AC , Y , MSK) < 

$'NAM==<Z LOCN> ;;LOCATION SYMBOL FOR DDT 

OP (<AC>, LOCN 1 'Y, MSK) >> ;;DEFINE MACRO TO HOLD LOCATION 

;..STR0 - PROCESS INSTANCE OF STRUCTURE USAGE, SINGLE STRUCTURE CASE 

DEFINE ..STRO (OP , AC , STR , Y ) < 

IFNDEF STR,<PRINTX ?STR IS NOT DEFINED 

OP (<AO,Y, .FWORD) > ;; RESERVE A WORD, ASSUME WORD MASK 
IFDEF STR,< 
IFNDEF %'STR,< 

OP (<AC> ,Y,STR) > ; ;ASSUME NO OTHER LOCN 
IFDEF %'STR,< 

%'STR (OP,<AC> ,Y,STR) >>> ; ; DO IT 
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;..STR1, . .STR2, . . STR3 , AND . . STR4 ARE INTERNAL MACROS FOR PROCESSING 
; INSTANCES OF STRUCTURE USAGE. 



DEFINE ..STR1 (OP , AC , STR, Y , CLL) < 

. .NS = = ;;INIT COUNT OF STR'S 

IRP STR,<. .NS=. .NS+1> ;; COUNT STR'S 
IFE ..NS,<PRINTX 7EMPTY STRUCTURE LIST, OP> 
IFE ..NS-1,< ; ;THE ONE CASE, CAN DO FAST 

. .STRO (OP,<AC> ,<STR> ,Y) > 



MORE THAN ONE, DO GENERAL CASE 
INIT REMOTE MACRO 
;CONS ON CALL AND FIRST ARGS 
DO ALL NAMES IN LIST 



IFG . .NS-1,< 

. .ICNS 

. .CNS (<CLL (OP,<AC> , ,> 

IRP STR,< 

IFNDEF STR,<PRINTX STP NOT DEFINED> 

IFDEF STR,< 

IFNDEF %'STR,< 

. .CNS (<,STP,Y>) > 

IFDEF % 'STR,< 

% 'STR ( . .STR2, ,Y,STR) > 

. .CNS (<) >) 

. .GCNS 

. . ICNS 

. .CNS (<CLL (OP,<AC>>) 

IFNDEF %'STR,< 

..CNS (<,STR,Y>)> 

IFDEF %'STR,< 

%'STR ( . .STR2, ,Y,STR) >>> ; ; PUT ON THIS ARG, END IRP 
..CNS (<,,)>) ; 7CLOSE ARG LIST 

..GCNS>> ;;DO LAST CALL 



; ASSUME NO OTHER LOCN 

;STR MACRO WILL GIVE LOCN TO 
CLOSE ARG LIST 
DO THIS AND PREVIOUS NAME 
REINIT CONS 

;PUT ON FIRST ARGS 



; ;ASSUME NO OTHER LOCN 



STR2 
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;..STR2 — CALLED BY ABOVE TO APPEND STRUCTURE NAME AND LOC TO ARG LIST 

DEFINE ..STR2 ( AA , LOC , STR) < 

. .CNS (<,STR,LQC>) > ; ;CONS ON NEXT ARG PAIR 

;..STR3 — CHECK FOR ALL STRUCTURES IN SAME REGISTER 

DEFINE ..STR3 (OP , AC , SI , LI , S2 , L2 ) < 
IFDIF <L1XL2>,< 
IFNB <L1>,< 

OP (<AC> ,L1 , . .MSK) ;;DO ACCUMULATED STUFF 
IFNB <L2>,<PRINTX SI AND S2 ARE IN DIFFERENT WORDS>> 
. .MSK==0> ; ;INIT MASK 

IFNB <L2>,< 

. .MSK=. .MSK!<S2>>> 

;..STR4 — COMPARE SUCCESSIVE ITEMS, DO SEPARATE OPERATION IF 
; DIFFERENT WORDS ENCOUNTERED 

DEFINE ..STR4 (OP , AC, SI , LI , S2 , L2 ) < 

IFDIF <L1XL2>,< ;;IF THIS DIFFERENT FROM PREVIOUS 
IFNB <L1>,< 

OP (<AC> ,L1 , . .MSK) > ;;DO PREVIOUS 

. .MSK==0> ;;REINIT MASK 
IFNB <L2>,< 

. ,MSK=. ,MSK!<S2>>> ;; ACCUMULATE MASK 

;..STR5 - SAME AS ,. .STR4 EXCEPT GIVES EXTRA ARG IF MORE STUFF TO 
; FOLLOW. 



DEFINE ..STR5 (OP , AC , SI , LI , S2 , L2 ) < 
IFDIF <L1XL2>,< 
IFNB <L1>,< 
IFNE <L2>,< 

OP" 1 (AC, LI,.. MSK 

IFB <L2>,< ; 

OP "2 ( AC, LI, . .MSK 

..MSK==0> ; 

IFNB <L2>,< 

. .MSK=. .MSK!<S2>>> 



IF THIS DIFFERENT FROM PREVIOUS, 

IF MORE TO COME, 
> ; ;DO VERSION 1 
IF NO MORE, 
>> ; ;DO VERSION 2 
REINIT MASK 

ACCUMULATE MASK 
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;' REMOTE 1 MACROS USED TO BUILD UP ARG LIST 

INITIALIZE CONS — DEFINES CONS 

DEFINE . . ICNS < 

DEFINE . .CNS (ARG) < 
. .CNS2 <ARG> ,> 

DEFINE ..CNS2 (NEW, OLD) < 
DEFINE ..CNS (ARG)< 

..CNS2 <ARG> ,<OLD'NEW>>> 
> 

;GET CONS — EXECUTE STRING ACCUMULATED 

DEFINE . .GCNS < 

DEFINE ..CNS 2 (NEW, OLD) < 

OLD> ; ;MAKE ..CNS2 DO THE STUFF 

..CNS ()> ;;GET ..CNS2 CALLED WITH THE STUFF 
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;SPECIFIC CASES 

LOAD, STORE 
AC - AC OPERAND 
STR - STRUCTURE NAME 
Y - (OPTIONAL) ADDITIONAL SPECIFICATION OF DATA LOCATION 

DEFINE LOAD (AC,STR,Y)< 

..STRO ( . .LDB,AC,STR,Y) > 

DEFINE ..LDB ( AC , LOC , MSK) < 
. .TSIZ ( . .PST,MSK) 
.CASE ..PST,<< 

MOVE AC, LOO, < 

HRPZ AC, LOO, < 

HLRZ AC, LOO, < 

LDB AC,[POINTR ( LOC ,MSK) ] >>> 

DEFINE STOR (AC,STR,Y)< 

..STRO ( . .DPB,AC,STR,Y) > 

DEFINE ..DPB ( AC , LOC , MSK) < 
. .TSIZ ( . .PST,MSK) 
.CASE ..PST,<< 

MOVEM AC, LOO ,< 

HRRM AC, LOO, < 

HRLM AC, LOO, < 

DPB AC,[POINTR (LOC , MSK) 1 >>> 

;SET TO ZERO 



DEFINE SETZRO (STR,Y)< 

..STR1 ( . .TQZ, ,<STR> ,Y, . .STR4) > 



DEFINE ..TQZ ( AC , LOC , MSK) < 
. .TSIZ ( . .PST,MSK) 
.CASE ..PST,<< 

SETZM LOO,< 

HLLZS LOO,< 

HRRZS LOO,< 

. .TSAC ( . .ACT, LOC) 

.IFO . .ACT,< 

MOVX .SAC, MSK 
ANDCAM .SAC, LOO, < 
..TX (Z , LOC, MSK) >>>> 



;;SET ..PST TO CASE NUMBER 



FULL WORD 

RH 

LH 

SEE IF LOC IS AC 



; ;NOT AC 
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;SET TO ONE 

DEFINE SETONE (STR,Y)< 

..STR1 ( . .TQO, ,<STR> ,Y. . . STR4 ) > 

DEFINE ..TQO ( AC , LOC , MSK ) < 
. .TSIZ ( . .PST,MSK) 
•CASE ..PST,<< 

SETOM LOO,< 

HLLOS LOC>,< 

HRROS LOO,< 

. .TSAC ( . .ACT, LOC) 

.IFO . .ACT,< 

MOVX .SAC, MSK 

IORM .SAC, LOO, < 

. .TX (0, LOC, MSK) >>>> 

;SET TO COMPLEMENT 



DEFINE SETCMP (STR,Y)< 

..STR1 ( . .TQC , ,<STR> ,Y, 



STR4) > 



DEFINE ..TQC ( AC , LOC , MSK) < 
. .TSIZ ( . .PST,MSK) 
.IFO ..PST,< 

SETCMM LOC>,< 
. .TSAC ( . .ACT, LOC) 
.IFO ..ACT,< 

MOVX .SAC, MSK 
XORM .SAC, LOO, < 
. .TX(C,LOC,MSK) >>> 



IF FULL WORD, 
CAN USE SETCMM 
OTHERWISE, CHECK FOR AC 
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; INCREMENT, DECREMENT FIELD 

DEFINE INCR (STR,Y) < 

..STRO (.INCRO, ,<STR>,Y) > 

DEFINE .INCRO ( AC , LOC , MSK) < 

. .PST==MSK&<-MSK> ; ;GET LOWEST BIT 
.IFO . .PST--1,< 

AOS LOC>,< ;;BIT 35, CAN USE AOS 

MOVX .SAC,..PST ;;LOAD A ONE IN THE APPROPRIATE POSITION 

ADDM .SAC,LOC>> 

DEFINE DECR (STR,Y) < 

..STRO (.DECRO, ,<STR>,Y) > 

DEFINE .DECRO (AC , LOC ,MSK) < 

. .PST==MSK&<-MSK> 

.IFO ..PST-1,< 

SOS LOC>,< ;;BIT 35, CAN USE SOS 

MOVX .SAC,-..PST ;;LOAD -1 IN APPROPRIATE POSITION 

ADDM .SAC,LOC>> 

; GENERAL DEFAULT, TAKES OPCODE 

DEFINE OPSTR (OP,STR,Y)< 

..STRO ( .OPSTl,<OP> ,<STR> ,Y) > 

DEFINE .OPST1 (OP , LOC , MSK ) < 

. .TSIZ ( . .PST,MSK) 

•IFO . .PST,< 

OP LOC>,< ;;FULL WORD, USE GIVEN OP DIRECTLY 
..LDB .SAC, LOC, MSK ;;OTHERWISE, GET SPECIFIED BYTE 
OP .SAC>> 

DEFINE OPSTRM (OP,STR,Y)< 

..STRO ( .OPST2,<OP> ,<STR> ,Y) > 

DEFINE .OPST2 (OP , LOC , MSK) < 
. .TSIZ ( . .PST,MSK) 
.IFO ..PST,< 

OP LOC>,< ;;FULL WORD, USE OP DIRECTLY 

. .LDB .SAC, LOC, MSK 

OP .SAC 

..DPB ,SAC,LOC,MSK>> 
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;JUMP IF ALL FIELDS ARE (ONE REGISTER AT MOST) 

DEFINE JE (STR,Y,BA)< 

. .STR1 ( . .JE,<BA>,<STR> ,Y, . .STR3) > 



DEFINE ..JE (BA,LOC,MSK) < 
. .TSAC ( . .ACT,LOC) 
.IFO ..ACT,< 

..TSIZ (..PST,MSK) 
.CASE ..PST,<< 
SKIPN LOC 
JRST BA>,< 
HRRZ .SAC, LOC 
JUMPE .SAC,BA>,< 
HLRZ .SAC, LOC 
JUMPE . SAC,BA>,< 
MOVE .SAC, LOC 
JXE ( .SAC,MSK,<BA>) >>>,< 
JXE (LOC,MSK,<BA>) >> 



SEE IF AC 

SEE WHICH CASE 

FULL WORD, TEST IN MEMORY 

RIGHT HALF, GET IT 

LEFT HALF, GET IT 

NOTA, GET WORD 



;JUMP IF NOT ALL FIELDS ARE (ONE REGISTER AT MOST) 

DEFINE JN (STR,Y,BA)< 

. .STR1 ( . .JN,<BA> ,<STR> ,Y, . .STR3) > 



DEFINE ..JN (BA,LOC,MSK) < 
. .TSAC ( . .ACT, LOC) 
.IFO ..ACT,< 

..TSIZ (..PST,MSK) 
.CASE ..PST,<< 
SKIPE LOC 
JRST BA>,< 
HRRZ .SAC, LOC 
JUMPN .SAC,BA>,< 
HLRZ .SAC, LOC 
JUMPN .SAC,BA>,< 
MOVE .SAC, LOC 
JXN ( .SAC,MSK,<BA>) >>>,< 
JXN (LOC,MSK,<BA>) >> 



; ;SEE IF AC 



FULL WORD, TEST IN MEMORY 
RIGHT HALF, GET IT 
LEFT HALF, GET IT 
NOTA, GET WORD 
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;JOR - JUMP ON 'OR 1 OF ALL FIELDS 

DEFINE JOR (STR,Y,BA)< 

. .STR1 ( . .JN,<BA>,<STR> ,Y, . . STR4 ) > 

;JNAND - JUMP ON NOT 'AND 1 OF ALL FIELDS 

DEFINE JNAND (STR,Y,BA)< 

. .STR1 ( . .JNA3,<BA> , <STR>,Y, . .STR4) > 

DEFINE ..JNA3 (BA, LOC , MSK) < 

. .TSAC ( . .ACT, LOC) 

.IFO . .ACT,< 

SETCM .SAC, LOC ; ;NOT AC, GET COMPLEMENT OF WORD 

JXN ( .SAC,MSK,<BA>) >,< ; ; JUMP IF ANY BITS ORIGINALLY OFF 

JXF (LOC,MSK,<BA>) >> ; ; DO AC CASE 
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;JAND - JUMP ON 'AND' OF ALL FIELDS 

DEFINE JAND (STR , Y , BA , %TG) < 

. .STR1 ( . .JAN,<%TG,<BA>>,<STR>,Y, . .STR5) 
%TG:> 

DEFINE ..JAN1 (BA1 , BA2 , LOC , MSK ) < 

..JNA3 (BAl,LOC,MSK) > ; ; DO JUMP NAND TO LOCAL TAG 

DEFINE ..JAN2 (BA1 , BA2 , LOC , MSK) < 

. .TSAC ( . .ACT, LOC) 

.IFO . .ACT,< 

SETCM .SAC, LOC ; ;NOT AC, GET COMPLEMENT OF WORD 

JXE ( .SAC,MSK,<BA2>) >,< ;;JUMP IF ALL BITS ORIGINALLY ONES 

JXO (LOC,MSK,<BA2>) >> ; ; DO AC CASE 

;JNOR - JUMP ON NOT 'OR 1 OF ALL FIELDS 

DEFINE JNOR (STR, Y , BA , %TG) < 

. .STR1 ( . .JNO,<%TG,<BA>>,<STR>,Y, . .STR5) 
%TG:> 

DEFINE ..JNOl (BAl,BA2,LOC,MSK) < 

..JN (BAl,LOC,MSK) > ;;DO JUMP OR TO LOCAL TAG 

DEFINE ..JN02 (BA1 , BA2 , LOC , MSK ) < 

..JE (<BA2> ,LOC,MSK) > ; ; DO JUMP NOR TO GIVEN TAG 

TEST AND MODIFY GROUP USING DEFINED STRUCTURES. TEST-ONLY AND 
MODIFY-ONLY PROVIDED FOR COMPLETENESS. 
GENERATES EXACTLY ONE INSTRUCTION 

DEFINE ..DOTY (M,T)< ;;MACRO TO DEFINE ALL CASES 

IRP M,< 
IRP T,< 

DEFINE TQ'M'T (STR,Y)< 

. .STR1 ( . .TY,M'T,<STR> ,Y, . .STR3) >>>> 

..DOTY (<N,0,Z ,C> ,<,E,N,A>) ; DO 16 DEFINES 
PURGE ..DOTY 
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; SPECIAL DEFINE FOR THE TWO CASES WHICH CAN TAKE MEMORY ARG 
;*NOTE* MAY GENERATE MORE THAN ONE INSTRUCTION - CANNOT BE SKIPPED 

DEFINE TMNE (STR,Y) < 

..STR1 (. .TYNE, ,<STR>,Y, . .STR3) > 

DEFINE ..TYNE (MT , LOC ,MSK) < 

..TSAC (..ACT, LOC) ;;SEE IF LOC IS AC 
.IFO . .ACT,< 
. .JX1==MSK 
.IFO <. .JX1-1B0>,< 
SKIPGE LOC>,< 
.IFO <. .JX1+1>,< 
SKIPE LOC>,< 
MOVE .SAC, LOC 
TXNE .SAC,MSK>>>,< 
TXNE LOC,MSK>> 

DEFINE TMNN (STR,Y) < 

..STR1 ( . .TYNN, ,<STR>,Y, . .STR3) > 

DEFINE ..TYNN (MT , LOC , MSK ) < 

..TSAC (..ACT, LOC) ;;SEE IF LOC IS AC 
.IFO ..ACT,< 
. .JX1==MSK 
.IFO <. .JX1-1B0>,< 
SKIPL LOC>,< 
•IFO <. .JX1+1> ,< 
SKIPN LOC>,< 
MOVE .SAC, LOC 
TXNN .SAC,MSK>>>,< 
TXNN LOC,MSK>> 

;ALL TY MACROS CALL . . TY AFTER INITIAL STRUCTURE PROCESSING 

DEFINE ..TY (MT , LOC , MSK) < 

..TSAC (..ACT, LOC) ;;SEE IF LOC IS AC 
.IFO ..ACT,< 

PRINTX PTQ'MT - LOC NOT IN AC> , < 

TX'MT LOC,MSK>> 



C-25 



MACSYM 

SUBTTL BLOCK MACROS 

; MACROS TO PROVIDE SOME BLOCK HANDLING OF CODE 

DO. - LOOP STRUCTURE, DECLARES TOP OF LOOP 
LOOP. - JUMPS TO TOP OF LOOP 
EXIT. - EXITS LOOP 

TOP. - TAG AT TOP OF LOOP FOR JUMPS, E.G. SOJG T4,TOP. 
ENDLP. - TAG AT END OF LOOP FOR JUMPS, E.G. SOJL T4, ENDLP, 



DEFINE DO. (%TGB,%TGE)< 

. .SVLD 
%TGB: ! 

DEFINE OD. < 
%TGE: ! 

.POPX> 
DEFINE LOOP. < 

JRST %TGB> 
DEFINE TOP. <%TGB> 
DEFINE ENDLP. <%TGE> 
DEFINE EXIT. < 

JRST %TGE>> 

DEFINE ENDDO. < 
OD.> 



;;SAVE CURRENT BLOCK 
; ;TOP OF LOOP 

; ;END OF LOOP 
; ; RESTORE DEFS 



LOOP TO TOP 

LABEL AT TOP FOR JUMPS 

LABEL AT END FOR JUMPS 



; ;EXIT LOOP 



DEFINE ..SVLD ( %SY1 , %SY2 , %SY3 , %SY4 ) < 
SYN OD. ,%SY1 
SYN LOOP. ,%SY2 
SYN TOP. ,%SY3 
SYN EXIT. ,%SY4 
•PSHX < 

SYN %SYl,OD. 

SYN %SY2,LOOP. 

SYN %SY3,TOP. 

SYN %SY4,EXIT.>> 
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;IFNSK., IFSKP. - "IF NO SKIP", "IF SKIP" 

;These macros cause the following code to be conditionally executed 
;depending on whether the preceding instruct ion (s) skipped or not. 
;The following code is ended with ENDIF., with ELSE, optional 
;within the range. 

;Note: both of these result in the same or fewer instructions than 

;the use of literals to handle the same cases. 

;Also, since the code is not in literals, the binary appears in the 

;listing, and the code is easier to follow with DDT. 

;If the preceding skip can be written in either sense, it is better 

;to use IFSKP. because one fewer instructions will be generated. 

;IFSKP. and IFNSK. have an alternate form where the consequence code 

;is given as a macro argument. In the normal case, no macro argument is given, 

"IF NO SKIP" CONSEQUENCE-CODE ALTERNATIVE-CODE 

If the instruction (s) preceding the macro does not skip, the 'consequence 

code 1 will be executed; otherwise (i.e. if the instruction skips) the 

'alternative code' will be executed. 



DEFINE IFNSK. (NSCOD , SKCOD , %TG1 , %TG2 ) < 



IFB <NSCOD'SKCOD> ,< 

. .SVDF 

TRNA 

JRST %TG1 
DEFINE ..TAGF (INST,PCT)< 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 

INST %TG2' 'PCT> 

> 
IFNB <NSCOD'SKCOD>,< 

JRST %TG1 

SKCOD 

JRST %TG2 
%TG1:! NSCOD 
%TG2: !>> 



; ;THE REGULAR FORM 

;;SAVE DEFINITIONS OF OUTER BLOCK 

; ;SKIP 

; ;JUMP PAST CODE 

;;SAVE THE FALSE TAG 

; ;SAVE THE END TAG 

;;TH*E ALTERNATE FORM 
; ;THE NOSKIP CASE 
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;If JSYS Error 



DEFINE IFJER. (NSCOD , SKCOD , %TG1 , %TG2 , %TG3 ) < 



IFB <NSCOD'SKCOD> , < 

. .SVDF 

ERJMP %TG3 

JRST %TG1 
%TG3: ! 

DEFINE ..TAGF ( INST , PCT) < 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST, PCT) < 

INST %TG2' 'PCT> 

> 
IFNB <NSCOD'SKCOD> , < 

ERJMP %TG1 

SKCOD 

JRST %TG2 
%TG1:I NSCOD 
%TG2: !>> 



THE REGULAR FORM 

SAVE DEFINITIONS OF OUTER BLOCK 

SKIP 

JUMP PAST CODE 



;;SAVE THE FALSE TAG 

; ;SAVE THE END TAG 

; ;THE ALTERNATE FORM 
; ;THE NOSKIP CASE 



; OBSOLETE NAME 

DEFINE IFNES. (ARG1,ARG2)< 

PRINTX % IFNES. should be changed to IFJER. 
IFJER. <ARG1> ,<ARG2>> 



"IF SKIP" CONSEQUENCE-CODE 

If the instruction (s) preceding the macro skips, the 'consequence 
code' will be executed. 



DEFINE IFSKP. (SKCOD , %TG , %TG2 ) < 
IFB <SKCOD>,< 
. .SVDF 
JRST %TG 
DEFINE ..TAGF (INST, PCT) < 

INST %TG* 'PCT> 
DEFINE ..TAGE (INST, PCT) < 
INST %TG2' 'PCT> 
> 
IFNB <SKCOD>,< 
JRST %TG 
SKCOD 
%TG: !>> 



; ; REGULAR FORM 

;;SAVE DEFINITIONS OF OUTER BLOCK 



; ;SAVE FALSE TAG 
; ;SAVE END TAG 
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;If No JSYS Error 



DEFINE IFNJE. ( SKCOD , %TG , %TG2) < 
IFB <SKCOD>,< 
. .SVDF 
ERJMP %TG 
DEFINE ..TAGF (INST,PCT)< 

INST %TG' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 
INST %TG2' 'PCT> 
> 
IFNB <SKCOD>,< 
ERJMP %TG 
SKCOD 
%TG: !>> 



; ; REGULAR FORM 

;;SAVE DEFINITIONS OF OUTER BLOCK 



; ;SAVE FALSE TAG 
; ;SAVE END TAG 



; OBSOLETE NAME 

DEFINE IFESK. (ARG) < 

PRINTX % IFESK. should be changed to IFNJE. 
IFNJE. <ARG>> 



C-29 



MACSYM 



;CONDITIONALS WHICH REPRESENT JUMP CASES - I.E. AC L, LE , G, ETC 
; IF CONDITION IS SATISFIED, DO BRACKETTED CODE 



DEFINE IFE. ( AC , %TG1 , %TG2 ) < 

JUMPN AC,%TG1 

. .SVDF 
DEFINE ..TAGF (INST,PCT)< 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 

INST %TG2' 'PCT> 

> 

DEFINE IFN. ( AC , %TG1 , %TG2 ) < 

JUMPE AC f %TGl 

. .SVDF 
DEFINE ..TAGF (INST,PCT)< 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 

INST %TG2' 'PCT> 

> 

DEFINE IFG. ( AC , %TG1 , %TG2) < 

JUMPLE AC,%TG1 

. .SVDF 
DEFINE ..TAGF (INST,PCT)< 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 

INST %TG2' 'PCT> 

> 

DEFINE IFGE. ( AC , %TG1 , %TG2) < 

JUMPL AC,%TG1 

. .SVDF 
DEFINE ..TAGF (INST,PCT)< 

INST %TG1 ' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 

INST %TG2' 'PCT> 

> 

DEFINE IFLE. ( AC , %TG1 , %TG2 ) < 

JUMPG AC,%TG1 

. .SVDF 
DEFINE ..TAGF (INST,PCT)< 

INST %TG1 ' 'PCT> 
DEFINE ..TAGE (INST,PCT)< 

INST %TG2' 'PCT> 

> 



; ;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ; DEFINE FALSE TAG 

; ; DEFINE END TAG 



; ;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ; DEFINE FALSE TAG 

; ; DEFINE END TAG 

; ;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ;DEFINE FALSE TAG 

; ; DEFINE END TAG 



; ;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ;DEFINE FALSE TAG 

; ; DEFINE END TAG 



; ;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ; DEFINE FALSE TAG 

; ; DEFINE END TAG 
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DEFINE IFL. ( AC , %TG1 , %TG2) < 

JUMPGE AC,%TG1 

. .SVDF 
DEFINE . .TAGF ( INST , PCT) < 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST, PCT) < 

INST %TG2' ' PCT> 

> 

DEFINE IFXE. ( AC , MASK , %TG1 , %TG2) 

JXN AC f MASK,%TGl 

. . SVDF 
DEFINE ..TAGF (:[NST f PCT)< 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST, PCT) < 

INST %TG2' 'PCT> 

> 

DEFINE IFXN. ( AC ,MASK , %TG1 , %TG2 ) 

JXE AC,MASK,%TG1 

. .SVDF 
DEFINE ..TAGF ( INST, PCT) < 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST, PCT) < 

INST %TG2' 'PCT> 

> 

DEFINE IFQE. (STR , Y , %TG1 , %TG2) < 

JN <STR>,<Y> ,%TG1 

. .SVDF 
DEFINE ..TAGF (INST, PCT) < 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST, PCT) < 

INST %TG2' 'PCT> 

> 

DEFINE IFQN. (STR, Y , %TG1 , %TG2) < 

JE <STR>,<Y>,%TG1 

. .SVDF 
DEFINE ..TAGF (INST, PCT) < 

INST %TG1' 'PCT> 
DEFINE ..TAGE (INST, PCT) < 

INST %TG2' 'PCT> 

> 



; ; JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ; DEFINE FALSE TAG 

; ; DEFINE END TAG 

< 

;;JUMP IF NOT CONDITION 

; ;SAVE OUTER BLOCK 

; ; DEFINE FALSE TAG 

; ;DEFINE END TAG 

< 

; ;JUMP IF NOT CONDITION 

; ;SAVE OUTER BLOCK 

; ;DEFINE FALSE TAG 

; ; DEFINE END TAG 



; ;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ;DEFINE FALSE TAG 

; ; DEFINE END TAG 



;;JUMP IF NOT CONDITION 
; ;SAVE OUTER BLOCK 

; ;DEFINE FALSE TAG 

; ; DEFINE END TAG 
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;GENERAL CASES WITHIN CONDITIONALS 

;"AND SKIP" 

DEFINE ANSKP. < 

..TAGF (JRST,)> ;;JUMP TO 'FALSE' 

DEFINE ANNSK. < 
TRNA 
..TAGF (JRST,)> ;;JUMP TO 'FALSE' 

DEFINE ELSE. <....U> ;; UNDEFINED UNTIL BLOCK ENTERED 

DEFINE ENDIF. < . . . .U> 
DEFINE . .TAGF <. . . .U> 
DEFINE . .TAGE <. . . .U> 

;"AND E" ETC. 

DEFINE ANDE. (AC) < 

..TAGF (<JUMPN AC,>,)> ;;JUMP IF NOT CONDITION 

DEFINE ANDN. (AC) < 

..TAGF (<JUMPE AC,>,)> ;;JUMP IF NOT CONDITION 

DEFINE ANDG. (AC) < 

..TAGF (<JUMPLE AC , > , ) > ;;JUMP IF NOT CONDITION 

DEFINE ANDGE. (AC) < 

..TAGF (<JUMPL AC,>,)> ;;JUMP IF NOT CONDITION 

DEFINE ANDLE. (AC) < 

..TAGF (<JUMPG AC,>,)> ;;JUMP IF NOT CONDITION 

DEFINE ANDL. (AC) < 

..TAGF (<JUMPGE AC , > , ) > ;;JUMP IF NOT CONDITION 

DEFINE ANDXE. (AC, MASK) < 

..TAGF (<JXN AC,MASK,>,)> ;;JUMP IF NOT CONDITION 

DEFINE ANDXN. (AC, MASK) < 

..TAGF (<JXE AC,MASK,>,)> ;;JUMP IF NOT CONDITION 

DEFINE ANDQE. (STR,Y)< 

..TAGF (<JN <STR>,<Y>,>,) > ;;JUMP IF NOT CONDITION 

DEFINE ANDQN. (STR,Y)< 

..TAGF (<JE <STR> ,<Y>,> , ) > ;;JUMP IF NOT CONDITION 
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; LOCAL WORKER MACROS 



;THIS INITS THE DEFINITIONS OF ELSE. AND ENDIF 
;NEW BLOCK. 



WHEN ENTERING A 



DEFINE . .INDF < 
DEFINE ELSE. < 

..TAGE (JFST,) 
..TAGF (,<:!>) 
SYN . .TAGE, . .TAGF 
DEFINE ELSE. <. . . .U>> 



JUMP TO END 

DEFINE THE FALSE TAG 

MAKE FALSE EQUIVALENT TO END 

ELSE CAN APPEAR ONCE ONLY 



DEFINE ENDIF. < 

..TAGF (,<:!>) 
. .RSDF> 
> 



; ; DEFINE FALSE TAG 

;; RESTORE DEFINITIONS OF OUTER BLOCK 
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;SAVE DEFINITIONS 

DEFINE ..SVDF ( %SY1 , %SY2 , %SY3 , %SY4 ) < 
SYN ELSE. ,%SY1 
SYN ENDIF. ,%SY2 
SYN . .TAGF,%SY3 
SYN . .TAGE,%SY4 
.PSHX < 

SYN %SY1,ELSE. 

SYN %SY2, ENDIF. 

SYN %SY3, . .TAGF 

SYN %SY4, . .TAGE> 
. .INDF ; ;REINIT DEFS 

> 

DEFINE . .RSDF < 
.POPX> 

; MACROS TO PUSH/POP STRINGS 

DEFINE .PSHX (STUFF) < 

.PSHX1 ( .PSHX2,<STUFF>) > 

DEFINE .PSHX1 (WCH, STUFF) < 
WCH (<STUFF>)> 

DEFINE .PSHX2 (OLD) < 

DEFINE .PSHX1 (WCH, STUFF) < 

WCH (<<STUFF> ,<OLD>>) >> 

DEFINE .POPX < 

.PSHX1 (.POPX2)> 

DEFINE .POPX2 (STUFF) < 
.POPX4 STUFF> 

DEFINE .POPX4 (JUNK , STUFF) < 
.POPX3 STUFF> 

DEFINE .POPX3 (TOP, REST) < 
TOP 
DEFINE .PSHX1 (WCH, STUFF) < 

WCH (<<STUFF> ,<PEST>>) >> 
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SUBTTL CALL, RET, JSERR 

IFE REL,< 

EXTERN JSERRO,JSMSGO,JSHLTO,R,RSKP> 

;CALL AND RETURN 

.AC1==1 ;ACS FOR JSYS ARGS 

•AC2==2 

.AC3==3 

.A16==16 ;TEMP FOR STKVAR AND TRVAR 

P=17 ; STACK POINTER 

OPDEF CALL [PUSH J P,0] 
OPDEF RET [POPJ P,0] 

;ABBREVIATION FOR CALL, RET, RETSKP 

OPDEF CALLRET fJP.STl 
.NODDT CALLRET 

DEFINE RETSKP <JRST RSKP> 

; MACRO TO PRINT MESSAGE ON TERMINAL 

DEFINE TMSG ($MSG) < 

HRROI .AC1,[ASCIZ \$MSG\1 
PSOUT> 

;MACRO TO OUTPUT MESSAGE TO FILE 
; ASSUMES JFN ALREADY IN .AC1 

DEFINE FMSG ($MSG) < 

HRROI .AC2,[ASCIZ \$MSG\] 

MOVE I .AC 3,0 

SOUT> 

; MACRO TO PRINT MESSAGE FOR LAST ERROR, RETURNS +1 

DEFINE PERSTR ($MSG)< 
IFNB <$MSG>,< 

TMSG <$MSG>> 
CALL JSMSG0> 

; MACRO TO PRINT JSYS ERROR MESSAGE, RETURNS +1 ALWAYS 

OPDEF JSERR[<CALL JSEPR0>1 



OPDEF EJSERR[<JUMP 17,JSERR0>] 



Since MACRO couldn't handle OPDEF of an OPDEF 
(i.e. ERCAL) defined elsewhere, use JUMP 17 
instead 



; MACRO FOR FATAL JSYS ERROR, PRINTS MSG THEN HALTS 



OPDEF JSHLT[<CALL JSHLT0>'| 
OPDEF EJSHLT[<JUMP 17,JSHLT0>] 



Since MACRO couldn't handle OPDEF of an OPDEF 
(i.e. ERCAL) defined elsewhere, use JUMP 17 
instead 



; PRINT ERROR MESSAGE IF JSYS FAILS 

DEFINE ERMSG(TEXT) ,< 

ERJMP [TMSG <? TEXT> 
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JSHLT] 
> 

;MAKE SYMBOLS EXTERN IF NOT ALREADY DEFINED 

DEFINE EXT (SYM) < 
IF2,< 

IRP SYM,< 

IFNDEF SYM,<EXTERN SYM 

SUPPRE SYM>>>> 
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; MACRO TO ADD BREAK CHARACTER TO FOUR WORD BREAK MASK (WO., Wl . , W2 . , W3 . ) 

DEFINE BRKCH. (%%V,V2) 

< 

%%FOO==%%V 

BRKO (%%FOO,V2,0) 
> 

; MACRO TO REMOVE CHARACTER 

DEFINE UNBRK. (%%V,V2) 

< 

%%FOO==%%V 

BRKO (%%FOO,V2,l) 
> 

DEFINE BRKO (% %1 1 ,V2 , FLAVOR) 

< . .V22==%%11 
. .V1==%%11 

IFNB <V2>,<. .V22==V2> 

REPEAT . .V22-<%%11>+1,< ;;BRACKETS AROUND %%11 IN CASE ITS AN EXPRESSION 
%%W==. .V1/~D32 ;, -DECIDE WHICH WORD CHARACTER GOES IN 
%%X==. .V1-%%W*~D32 ;, -CALCULATE BIT POSITION WITHIN WORD 
IFE FLAVOR, BRKC1 \"<%%W+"0"> ;, -MODIFY CORRECT MASK WORD 
I FN FLAVOR, BRKC 2 \"<%%W+"0"> 
. .Vl==. .Vl+1 
> 

> 

DEFINE BRKC1 (ARG1) 

< W'ARGl 1 •==W'ARG1 I . !<1B<%%X>> 
> 

DEFINE BRKC2 (ARG1) 

< W'ARGl 1 .==W'ARG1' . & <-l-lB< % %X> > 
> 

;MACRO TO INITIALIZE 4-WORD 12-BIT CHARACTER BREAK MASK 

DEFINE BRINI. ( A0<0> , A1<0> , A2<0> , A3<0> ) 

< 

W0.==A0 

W1.==A1 ; INITIALIZE BREAK MASK 

W2.==A2 

W3.==A3 

> 

; MACRO TO DEFINE A BREAK SET 

DEFINE BRMSK. ( INIO , INIl , INI 2 , INI 3 , ALLOW ,DISALW) 

< BRINI. INIO, INIl ,INI2,INI3 ;;SET UP INITIAL MASK 

IRPC ALLOW, < UNBRK. "ALLOW"> ; ; DON ' T BREAK ON CHARS TO BE ALLOWED IN FI 

IRPC DISALW,< BRKCH. "DISALW"> ;;BREAK ON CHARACTERS NOT ALLOWED 

EXP WO. ,W1. ,W2. ,W3. ;;STORE RESULTANT MASK IN MEMORY 

> 
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COMND - MACRO FOR BUILDING FUNCTION DESCRIPTOR BLOCK 

THIS IS THE OLD ONE, BEFORE . CMBRK EXISTED. USE FLDBK. FOR SPECIFYING 

BREAK SETS 

DEFINE FLDDB. (TYP , FLGS ,DATA , HLPM ,DEFM , LST) < 

. . XX==<FLD(TYP,CM%FNC) >+FLGS+<0 , ,LST> 
IFNB <HLPM>,<. .XX=CM%HPP! . .XX> 
IFNB <DEFM> ,<. .XX=CM%DPP! . .XX> 

. .XX 
IFNB <DATA> ,<DATA> 
IFB <DATA>,<0> 

IFNB <HLPM> ,<POINT 7,[ASCIZ ~VHLPM~Vl > 
IFB <HLPM>,<IFNB <DEFM>,<0>> 
IFNB <DEFM>,<POINT 7 f [ASCIZ \DEFM\1>> 

;COMND - MACRO FOR BUILDING FUNCTION DESCRIPTOR BLOCK 

DEFINE FLDBK. (TYP , FLGS , DATA , HLPM , DEFM , BRKADR , LST) < 

. .XX==<FLD(TYP,CM%FNC) >+FLGS+<Z LST> 
IFNB <HLPM> ,<• .XX=CM%HPP! . . XX> 
IFNB <DEFM> ,<. .XX=CM%DPP! . .XX> 
IFNB <BRKADR>,<. .XX=CM%BRK! . . XX> 

. .XX 
IFNB <DATA> , <DATA> 
IFB <DATA>,<0> 

IFNB <HLPM> ,<POINT 7,[ASCIZ ~VHLPM~V] > 
IFB <HLPM>,<IFNB <DEFM ' BRKADP> , <0 > > 
IFB <DEFM>,<IFNB <BRKADR> , <0 > > 
IFNB <DEFM> ,<P0INT 7,[ASCIZ \DEFM\]> 
IFNB <BRKADR>,<BRKADR> 
> 
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;USEFUL EXTENDED ADDRESSING DEFINITIONS 

OPDEF XMOVEI [SETMI] ; EXTENDED MOVE IMMEDIATE 

OPDEF XHLLI [HLLI] ;NOT YET IN MACRO 

DEFINE XBLT. (A) < 

EXTEND A, [XBLT] > 
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SUBTTL SUPPORT CODE FOR JSEPR 
IFN REL,< 



A=l 
B=2 
C = 3 
D=4 



JSYS ERROR HANDLER 
CALL JSERRO 
RETURNS +1: ALWAYS, CAN BE USED IN +1 RETURN OF JSYS • S 



JSERRO: :MOVEI A,.PRIIN 

CFIBF 

MOVEI A, .PRIOU 

DOBE 

TMSG < 
? JSYS ERROR: > 
JSMSGO: :MOVEI A,. PRIOU 

HRLOI B,.FHSLF 

SETZ C, 

ERSTR 
JFCL 
JFCL 

TMSG < 



; CLEAR TYPAHEAD 

;WAIT FOR PREVIOUS OUTPUT TO FINISH 

;SAY THIS FORK ,, LAST ERROR 



> 



RET 



FATAL JSYS ERROR - PRINT MESSAGE AND HALT 
CALL JSHLTO 
RETURNS: NEVER 

JSHLTO: :CALL JSERRO ;PRINT THE MSG 

JSHLT1: HALTF 

TMSG <PROGRAM CANNOT CONTINUE 
> 

JRST JSHLT1 ;HALT AGAIN IF CONTINUED 

> ;END OF IFN REL, 
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SUBTTL STKVAR - STACK VARIABLE FACILITY 

MACRO FOR ALLOCATING VARIABLES ON THE STACK. ITS ARGUMENT IS 
A LIST OF ITEMS. EACH ITEM MAY BE: 

1. A SINGLE VARIABLE WHICH WILL BE ALLOCATED ONE WORD 

2. A VARIABLE AND SIZE PARAMETER WRITTEN AS <VAR,SIZ>. THE 

VARIABLE WILL BE ALLOCATED THE SPECIFIED NUMBER OF WORDS. 
RETURN FROM A SUBROUTINE USING THIS FACILITY MUST BE VIA 
RET OR RETSKP. A DUMMY RETURN WHICH FIXES UP THE STACK IS PUT ON 
THE STACK AT THE POINT THE STKVAR IS ENCOUNTERED. 

WITHIN THE RANGE OF A STKVAR, PUSH/POP CANNOT B*I USED AS THEY WILL 
CAUSE THE VARIABLES (WHICH ARE DEFINED AS RELATIVE STACK LOCATIONS) 
TO REFERENCE THE WRONG PLACE. 
TYPICAL USE: STKVAR <AA , BB , <QQ , 5> , ZZ> 

ENDSV. ;END OF SCOPE OF NAMES 

IFE REL,< 

EXTERN .STKST, . STKRT> 

DEFINE STKVAR (ARGS)< 

..STKR==10 ;;REMEMBER RADIX 

RADIX 8 
. .STKN==0 
IRP ARGS,< 

.STKV1 (ARGS)> 
JSP .A16,. STKST 
. .STKN, , . .STKN 
RADIX . .STKR 

DEFINE ENDSV. < . ENSV1 <ARGS>> 
> 

; INTERMEDIATE MACRO TO PEAL OFF ANGLEBRACKETS IF ANY 

DEFINE .STKV1 (ARG) < 
.STKV2 (ARG)> 

INTERMEDIATE MACRO TO CALCULATE OFFSET AND COUNT VARIABLES 

DEFINE .STKV2 (VAR,SIZ)< 

IFB <SIZ>,<. .STKN===. .STKN+1> 
IFNB <SIZ> ,<. . STKN==. .STKN+SIZ> 
. .STKQ==. .STKN+1 
.STKV3 (VAR,\- -STKQ) > 

; INNERMOST MACRO TO DEFINE VARIABLE 

DEFINE .STKV3 (VAR,LOC)< 

IFDEF VAR,<.IF VAR , SYMBOL , <PRINTX STKVAR VAR ALREADY DEFINED>> 
DEFINE VAR<-~0'LOC(P) > 
$'VAR==<Z VAR>> ;SYMBOL FOR DDT 

; CLEANUP NAMES 

DEFINE .ENSV1 (ARGS)< 
IRP ARGS,< 

.ENSV2 (ARGS)>> 

DEFINE .ENSV2 (ARG) < 
.ENSV3 (ARG)> 

DEFINE .ENSV3 (ARG,SIZ)< 
DEFINE ARG<. . . .U>> 
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IFN REL,< 
; COMMON ENTRY AND EXIT ROUTINE FOR STACK VARIABLE 
ENTRY .STKST 



.STKST: :ADD P,0 (.A16) 

JUMPGE P,STKSOV 
STKSE1: PUSH P,0(.A16) 

PUSHJ P,1(.A16) 
.STKRT::JRST STKRTO 

POP P, .A16 

SUB P, .A16 

AOS 0(P) 

RET 

STKRTO: POP P, .A16 
SUB P, .A16 
RET 

STKSOV: SUB P,0 (. A16) 

HLL .A16,0(.A16) 

STKSOl: PUSH P, [0] 

SUB .A16,[l,,0] 
TLNE .A16, 777777 
JRST STKSOl 
JRST STKSE1 



BUMP STACK FOR VARIABLES USED 

TEST FOR STACK OVERFLOW 

SAVE BLOCK SIZE FOR RETURN 

CONTINUE ROUTINE, EXIT TO .+1 

NON-SKIP RETURN COMES HERE 

SKIP RETURN COMES HERE-RECOVER COUNT 

ADJUST STACK TO REMOVE BLOCK 

NOW DO SKIP RETURN 



RECOVER COUNT 

ADJUST STACK TO REMOVE BLOCK 

DO NON-SKIP RETURN 

STACK OVERFLOW- UNDO ADD 

SETUP TO DO MULTIPLE PUSH, GET COUNT 

DO ONE PUSH AT A TIME, GET REGULAR 

ACTION ON OVERFLOW 
COUNT DOWN TO 0? 
NO, KEEP PUSHING 



;END OF IFN REL, 
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SUBTTL TRVAR - TRANSIENT VARIABLE FACILITY 

TRANSIENT (STACK) VARIABLE FACILITY - EQUIVALENT TO STKVAR 
EXCEPT ALLOWS VARIABLES TO BE USED WITHIN LOWER LEVEL ROUTINES 
AND AFTER OTHER THINGS HAVE BEEN PUSHED ON STACK. 
N.B. USES . FP AS FRAME POINTER - MUST NOT BE CHANGED WHILE 
VARIABLES IN USE, 

.FP==15 ; DEFAULT FRAME POINTER 

IFE REL,< 

EXTERN .TRSET, .TRRET, .ASSET, .SASET, .ASRET> 

DEFINE TRVAR (VARS) < 

..TRR==10 ;; REMEMBER CURRENT RADIX 

RADIX 8 

..NV==1 ;;INIT COUNT OF STACK WORDS 

IRP VARS,< 

.TRV1 (VARS)> ;;PROCESS LIST 

JSP .A16,. TRSET ; ;ALLOCATE STACK SPACE, SETUP . FP 

. .NV-1, , . .NV-1 
RADIX ..TRR ;;RESTORE RADIX 

DEFINE ENDTV.<.ENSV1 <VARS>> 
> 

DEFINE .TRV1 (VAR) < 

.TRV2 (VAR)> ;;PEEL OFF ANGLEBRACKETS IF ANY 

DEFINE .TRV2 (NAM,SIZ)< 

.TRV3 (NAM,\..NV) ;;DEFINE VARIABLE 
IFB <SIZ>,<. .NV=. .NV+1> 
IFNB <SIZ> ,<. .NV=. .NV+SIZ>> 

DEFINE .TRV3 (NAM,LOC)< 

IFDEF NAM,<.IF NAM , SYMBOL , <PRINTX TRVAR NAM ALREADY DEFINED>> 
DEFINE NAM<~0'LOC( .FP) > 
$'NAM==<Z NAM>> ;, -SYMBOL FOR DDT 

;AC SUBROUTINE - ENTRY FOR SUBROUTINE CALLED WITH 1-4 ARGS IN ACS T1-T4 
;USES .FP AS FRAME PTR LIKE TRVAR 

DEFINE ASUBR (ARGS)< 

..TRR==10 ;;SAVE RADIX 

RADIX 8 

. .NV==1 ;;INIT ARG COUNT 

IRP ARGS,< 

.TRV1 (ARGS)> ;;DEFINE ARG SYMBOL 

IFG . .NV-5,<PRINTX ?TOO MANY ARGUMENTS: ARGS> 

JSP .A16,. ASSET ;, -SETUP STACK 

RADIX ..TRR ;;RESTORE RADIX 

DEFINE ENDAS.<.ENSV1 <ARGS>> 

> 
;SAME AS ABOVE EXCEPT ALSO RESTORES T1-T4 FROM STACK 
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DEFINE SASUBR (ARGS) < 

. ,TRR==10 ;;SAVE RADIX 

RADIX 8 

..NV==1 ;;INIT ARG COUNT 

IRP ARGS,< 

.TRV1 (ARGS)> ;;DEFINE ARG SYMBOL 

IFG . .NV-5,<PPINTX ?TOO MANY ARGUMENTS: ARGS> 
JSP .A16,.SASET ;;SETUP STACK 

RADIX ..TRR ;;RESTOPE RADIX 

DEFINE ENDSA.<.ENSV1 <ARGS>> 
> 
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IFN REL,< 
; SUPPORT ROUTINE FOR TRVAR 

.TRSET: :PUSH P , . FP 
MOVE .FP,P 
ADD P,0(.A16) 
JUMPGE P,TRSOV 



TRSET1: 


PUSHJ P,1(.A16) 


.TRRET: 


:JRST [ MOVEM . FP,P 




POP P, .FP 




POPJ P,] 




MOVEM .FP,P 




POP P, .FP 




AOS 0(P) 




POPJ P, 


TRSOV: 


MOVE P , . FP 




PUSH P, .A16 




HRRZ .A16,0(.A16) 




ADJSP P,-1(.A16) 




MOVE .A16,1(.FP) 




JRST TRSET1 



; SUPPORT ROUTINE FOR ASUBR 

.ASSET: :PUSH P, . FP 

MOVE .FP,P 

ADJSP P,4 

DMOVEM A,1(.FP) ;SAVE 

DMOVEM C,3 ( .FP) 

PUSHJ P, (.A16) 
.ASRET:: JRST [ MOVEM . FP,P 
POP P, .FP 
POPJ P,] 

MOVEM .FP,P 

POP P, .FP 

AOS 0(P) 

POPJ P, 

; SUPPORT ROUTINE FOR SASUBR 

.SASET: :PUSH P , . FP 

MOVE .FP,P 

ADJSP P,4 

DMOVEM A,1(.FP) ; SAVE 

DMOVEM C,3(.FP) 

PUSHJ P,0 (.A16) 
.SARET:: JRST [ DMOVE A,1(.FP) 
DMOVE C,3(.FP) 
MOVEM . FP,P 
POP P, .FP 
POPJ P,] 

DMOVE A,l ( .FP) 

DMOVE C,3(.FP) 

MOVEM . FP,P 

POP P, .FP 

AOS 0(P) 

POPJ P, 



PRESERVE OLD . FP 
SETUP FRAME PTR 
ALLOCATE SPACE 

CONTINUE ROUTINE, EXIT VIA .+1 
CLEAR STACK 
RESTORE OLD . FP 

;HERE IF SKIP RETURN 

;PASS SKIP RETURN 



STACK OVERFLOW, UNDO ADD 

SAVE LOCAL RETURN 

GET COUNT 

ADJUST STACK, GET TRAP HERE OR ON PUSH 

RESTORE LOCAL RETURN 

NOW CHARGE AHEAD 



SAVE . FP 

SETUP FRAME POINTER 
BUMP STACK 
ARGS 

; CONTINUE ROUTINE 

;NO-SKIP RETURN, CLEAR STACK 



;SKIP RETURN, CLEAR STZCK 



SAVE . FP 

SETUP FRAME POINTER 
BUMP STACK 
ARGS 

; CONTINUE ROUTINE 
; RESTORE 

;NO-SKIP RETURN, CLEAR STACK 

; RESTORE 

;SKIP RETURN, CLEAR STACK 

;END OF IFN REL, 
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;AC VARIABLE FACILITY 

IFE REL,< 

EXTERN .SAV1, .SAV2, . SAV3, . SAV4 , .SAV8> 

.FPAC==5 ; FIRST PRESERVED AC 

.NPAC==10 ;NUMBER OF PRESERVED ACS 

DEFINE ACVAR (LIST)< 

..NAC==0 ;;INIT NUMBER OF ACS USED 

IRP LIST,< 

.ACV1 (LIST)> ;, -PROCESS ITEMS 

•ACV3 (\..NAC) ;;SAVE ACS USED 

DEFINE ENDAV.< . ENAV1 <LIST>>> 

DEFINE .ACVl (ITEM)< 

•ACV2 (ITEM)> ;;PEEL OFF ANGLEBRACKETS IF ANY 

DEFINE .ACV2 (NAM,STZ)< 

IFDEF NAM,<.IF NAM , SYMBOL , <PRINTX ACVAR NAM ALREADY DEFINED>> 
NAM==.FPAC+. .NAC ;;DEFINE VARIABLE 

$'NAM==NAM ;;FOR DDT 

IFB <SIZ> ,<. .NAC=. .NAC+1> 
IFNB <SIZ>,<. .NAC=. .NAC + SIZ>> 

DEFINE .ACV3 (N)< 

IFG N-.NPAC,<PFINTX ?TOO MANY ACS USED> 
IFLE N-4,< 

JSP .A16,.SAV'N> ;;SAVE ACTUAL NUMBER USED 
IFG N-4,< 

JSP .A16,.SAV8>> ;;SAVE ALL 

DEFINE .ENAV1 (ARGS)< 
IRP ARGS,< 

.ENAV2 (ARGS)>> 

DEFINE .ENAV2 (ARG) < 
.ENAV3 (ARG)> 

DEFINE .ENAV3 (NAM,SIZ)< 

PURGE NAM, NAM 
> 

IFN REL,< 
;SUPPORT ROUTINES FOR AC VARIABLE FACILITY 

.SAV1: : PUSH P, . FPAC 

PUSHJ P,0(.A16) ;CONTINUE PROGRAM 

SKIPA 
AOS -1 (P) 
POP P, .FPAC 
POPJ P, 

.SAV2: : PUSH P, .FPAC 

PUSH P, .FPAC+1 
PUSHJ P,0(.A16) 

SKIPA 
AOS -2(P) 
POP P, .FPAC+1 
POP P, .FPAC 
POPJ P, 
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SAV3: : 

SAV4: : PUSH P, . FPAC 

PUSH P, . FPAC+1 

PUSH P, .FPAC+2 

PUSH P, . FPAC+3 

PUSHJ P,0(.A16) 
SKIPA 

AOS -4(P) 

POP P, .FPAC+3 

POP P, .FPAC+2 

POP P, .FPAC+1 

POP P, .FPAC 

POP J P, 

,SAV8: : ADD P, [10, ,10] 

JUMPGE P, [HALT . ] 
DMOVEM .FPAC,-7(P) 
DMOVEM . FPAC+2, -5 (P) 
DMOVEM . FPAC+4,-3 (P) 
DMOVEM . FPAC+6,-1 (P) 
PUSHJ P,0(.A16) 

SKIPA 
AOS -10(P) 
DMOVE .FPAC+6,-1 (P) 
DMOVE .FPAC+4,-3 (P) 
DMOVE . FPAC+2, -5 (P) 
DMOVE ,FPAC,-7(P) 
SUB P, [10, ,101 
POP J P, 
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AC SAVE FACILITY - COMPILES OPEN PUSH'S 

SAVEAC <LIST-OF-ACS> 
DUMMY ROUTINE PUT ON STACK TO CAUSE AUTOMATIC RESTORE. SUPPORTS 
+1 OR +2 RETURNS. 

DEFINE SAVEAC (ACS) < 
.NAC==0 
IRP ACS,< 

PUSH P,ACS ;;SAVE AN AC 

.NAC=.NAC+1> ;;COUNT THEM 

•N1==.NAC 

SETMI .A16,[CAIA ;;STACK DUMMY RETURN 

AOS -.N1(P) ;, -HANDLE SKIP RETURN 
IRP ACS,< 

.N1=.N1-1 

MOVE ACS,-.N1(P)> ;;RESTORE AN AC 
SUB P, [ .NAC, , .NAC] ;, -CLEAR STACK 
POPJ P,] ;, -FINAL RETURN 

PUSH P, .A16> 

IFN REL,< 
; STANDARD RETURNS 

RSKP: : AOS (P) 
R:: RET 

> ;END OF IFN REL, 
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SUBTTL BLSUBR - BLISS-STYLE SUBROUTINE MECHANISM 

MACROS FOR STACK-STYLE (BLISS) SUBROUTINE ENTRY 

BLSUBR DEFINE A SUBROUTINE ENTRY POINT. IT TAKES THE LIST OF 

SYMBOLS WHICH WILL BE BOUND TO VALUES ON THE STACK AT ENTRY TO 

THE ROUTINE. A STACK FRAME POINTER IS SETUP IN . FP AND MUST 

BE UNDISTURBED THROUGH THE ROUTINE. OTHER MECHANISMS WHICH 

USE THE STACK (E.G. SAVEAC) CAN BE USED. 

AN OPTIONAL LIST OF VARIABLES IN THE SAME FORMAT AS FOR TRVAR CAN 

BE GIVEN TO ALLOCATE LOCAL DYNAMIC STORAGE. 

; SUBROUTINES DEFINED HEREBY ARE CALLED WITH BLCALL. 

IFE REL,< 

EXTERN .ENTER> 



DEFINE BLSUB. (ARGS,VARS)< 
. .TRR==10 
RADIX 8 
. .NA==2 
IRP ARGS,< 

. .NA=. .NA+1> 
IRP ARGS,< 

• BLSU1 (AF.GS,\- -NA) 

. .NA=. .NA-1> 
. .NV==1 
IRP VARS,< 

.TRV1 (VARS)> 
DEFINE ENDBS. <.ENBS1 <ARGS> 
.ENSV1 <VARS>> 
JSP .A16,. ENTER 
. .NV-1, , . .NV-1 
RADIX ..TRR> 



;ARGUMENTS, LOCAL VARIABLES 

; REMEMBER CURRENT RADIX 

;SO BACKSLASH ARGS WILL WORK HEREIN 

;INIT ARG COUNT 

; COUNT ARGS 

; DEFINE AN ARG 

; SETUP TO COUNT VARIABLE STORAGE 

; COUNT WORDS AND DEFINE SYMBOLS 

SAVE SYMBOLS 

; ; SETUP FRAME PTR 



DEFINE .BLSU1 (ARG,LOC)< 

DEFINE ARG<-~0'LOC( . FP) > 
$'ARG==<Z ARG>> 

DEFINE .ENBS1 (ARGS)< 
IRP ARGS,< 
DEFINE ARGS<. . . .U>>> 
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CALL STACK-STYLE (BLISS) SUBROUTINE 

THIS MACRO TAKES THE NAME OF THE SUBROUTINE AND A LIST OF ARGUMENTS. 

EACH ARGUMENT IN THE ARG LIST IS ONE OF THE FOLLOWING: 

1. A NORMAL EFFECTIVE ADDRESS SPECIFICATION, E.G. FOO, @FIE(X) 

2. AN IMMEDIATE ADDRESS WRITTEN AS <.,ADR> WHERE ADR IS AN EFFECTIVE 

ADDRESS SPECIFICATION, E.G. FOO, @FIE(X). NOTE THAT THIS 

ADDRESS WILL BE COMPUTED BY AN XMOVEI AT THE TIME OF THE CALL 

SO SECTION INFORMATION WILL BE BOUND AT THAT TIME. NOTE ALSO 

THAT THIS FORM SHOULD *NOT* BE USED FOR A LITERAL CONSTANT 

WHERE YOU WOULD NOT WANT THE CURRENT SECTION PUT IN THE LEFT 

HALF. USE [CONST] INSTEAD. YES, THE DOT HERE IS LIKE NO-DOT IN BLIS 

AND VICE-VERSA. 

3. A STRUCTURE REFERENCE SPECIFICATION, E.G. AAA, <BB,(X)>. IF 

THE LATTER FORM IS USED, THE BRACKETS ARE REQUIRED. 



DEFINE BLCAL. (NAME,ARGS)< 
. .NA = = 
IRP ARGS,< 

.BLCL2 ARGS> 
PUSH P, [ . .NA+1, , . .NA+1] 
PUSHJ P,NAME 



; ;INIT APG COUNT 

; ;COMPILE PUSH 

;;COUNT OF ARGS AND SELF 

; ;JUMP TO SUBR 



; SEPARATE PAIRED ARGS 

DEFINE .BLCL2 (ARGS)< 
.BLCL1 ARGS> 



DEFINE .BLCL1 (ARG1,ARG2)< 
IFIDN <ARG1X.>,< 

XMOVEI .A16,ARG2 
PUSH P, .A16> 
IFDIF <ARG1X.>,< 
.IFATM <ARG1> , .BLF1 
IFN .BLF1,< 
.BLF1==0 
.IF % 'ARG1, MACRO, < 

.BLF1==1> 
IFNB <ARG2>,< 
•BLF1==1> 
IFN .BLF1,< 

LOAD .A16,ARG1,ARG2 
PUSH P, .A16>> 
IFE .BLF1,< ;IF WASN'T A STRUCTURE REF , 

PUSH P,ARG1>> ;;PUSH ONE ARG 
. .NA=. .NA+1> 



; ; IMMEDIATE ARG 

;;SEE IF ARG IS ATOMIC 

;;SET TO 1 IFF STRUCTURE REF 

;; CHECK RELATED STRUCTURE SYMBOL 

; ;IS A STRUCTURE 

;;SECOND ARG IMPLIES STRUCTURE TOO 
;;'OR' OF ABOVE TWO CHECKS 



MACRO TO SEE IF STRING IS AN ATOM, I.E. CONTAINS ONLY LEGAL SYMBOL 

CONSTITUENTS A-Z , 0-9, %, $, . 

IT IS PAINFULLY SLOW, BUT MACRO PROVIDES NO OTHER WAY 

FLAG WILL BE SET TO 1 IF STRING IS ATOM, OTHERWISE 



DEFINE .IFATM (S,FLG)< 
IRPC S,< 
FLG==0 

IFGE "S"-"A" ,<IFLE " S" - " Z " , <FLG=1>> ;;SET FLG IF LETTER OK 
IFGE "S ,, -"0 ,, ,<IFLE " S" -" 9 " , <FLG=1> > 
IFE "S"-"%" ,<FLG=1> 
IFE "S"-"$" ,<FLG=1> 
IFE "S"-" . " ,<FLG=1> 
IFE FLG,<STOPI>>> 
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.ENTER: :PUSH P , . FP 

MOVE .FP,P 

ADD P,0(.A16) 

JUMPGE P,ENTOV 
ENTOV1: PUSHJ P,1(.A16) 

JRST [ MOVE P, .FP 
JRST ENTX1] 

MOVE P, .FP 

AOS -1 (P) 
ENTX1: POP P, .FP 

POP P, .A16 

SUB P,0(P) 

JRST O(.AKi) 

ENTOV: MOVE P , . FP 
PUSH P, .A16 
HRRZ .A16,0(.A16) 
ADJSP P,-1(.A16) 
MOVE .A16,1(.FP) 
JRST ENTOVl 



; ALLOCATE LOCAL STORAGE 
;JUMP IF OVERFLOW 

; RESET STACK PTR 



; PROPAGATE SKIP 



; REMOVE ARGS 
; RETURN 

STACK OVERFLOW, UNDO ADD 

SAVE LOCAL RETURN IN l(.FP) 

GET COUNT 

ALLOCATE SPACE, GET TRAP HERE OR ON PUSH 

RESTORE LOCAL RETURN 

CHARGE AHEAD 

END IFN REL 
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SUBTTL ERROR-MESSAGE SUPPORT FOR MACROS 



;Macro to print current location, macro name, and text 
DEFINE MPRNTX (MNAME,TEXT) 

<DEFINE ..MP. (LOCN, MTEXT, PTEXT) 

<PRINTX Location 'LOCN 1 , Macro 'MTEXT': PTEXT 
> 
. .MP. (\. ,MNAME,<TEXT>) 
PURGE ..MP. 
> 

;Macro to print current location and text 
DEFINE EPRNTX (TEXT) 

<DEFINE ..EP. (LOCN, PTEXT) 

<PRINTX Location 'LOCN 1 : PTEXT 
> 
. .EP. (\. ,<TEXT>) 
PURGE ..EP. 
> 
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SUBTTL MACROS TO SUPPORT EXTENDED ADDRESSING 

Local format indirect word 

!1!0! Reserved ! I ! X ! ADDR ! 

!0!1!2 12! 13114 17118 35! 



;Macro to generate local-format (instruction-format) indirect words 
; Args : 

; ADDR 18-bit in-section address (indexing or indirection 
; may be specified) 

;Generates Q errors on the following: 

Bits 0-12 non-zero in ADDR 

DEFINE LFIWM (ADDR) 

<..ERR.=0 ;;Reset error flag 

IFN <<ADDR>;;<"0<777740, ,0>>>, 

<MPRNTX (LFIWM, Bits 0-12 non-zero in address field: ADDR) 

. .ERR.=1 

> 
IFN . .ERR. ,<-l ,-1 ,-]> ;, -Generate Q error 

IFE . .ERR. ,<1BO!<<~0<400037, ,-l> >& <ADDR> >> ;;Generate LFIW 
PURGE ..ERR. 
> 
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Global format indirect word 

!0! I ! X ! SEC ! ADDR ! 

!0! 1 !2 5!6 17! 35! 

Macro to generate global-format (extended-format) indirect words 
Args : 

SEC 12-bit section number 

ADDR 18-bit in-section address (indexing or indirection 
may be specified) 

Generates Q errors on the following: 

Bits 0-12 non-zero in ADDR 
SEC greater than 12 bits 

DEFINE GFIWM (SEC, ADDR) 

<..ERR.=0 ;;Reset error flag 

IFN <<SEC>&<~0<-1, ,770000>>>, 

<MPRNTX (GFIWM, Section greater than 12 bits: SEC) 

. .ERR.=1 

> 
IFN <<ADDR>&<~0<777740, ,0>>>, 

<MPRNTX(GFIWM,Bits 0-12 non-zero in address field: ADDR) 

. .ERR.=1 

> 
IFN . .ERR. ,<-l,-l,-l> ;;Generate Q error 

; ;Generate GFIW 
IFE . .ERR. ,< 

<<<ADDR>_<r014>>&<~0< 370000, , 0>> ! <<ADDR>&<0 , ,-l>> ! <<SEC>_<~022>>>> 
PURGE ..ERR. 
> 
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The following macros generate all flavors of 1 and 2-word 
global and local byte pointers. They are similar to the 
POINT pseudo-op, with the following exceptions: 

1. The basic argument triad of (bytesize , address , by te position) 
is maintained. However, some of the macros will prefix 
and-or postfix the triad with additional argument(s). 

2. Numeric arguments are always interpreted in the current radix. 
Assuming the current radix is octal, note the following 
equivalences : 

a. POINT 10,200,36 

b. L1BPT(12,200,44) 

c. L1BPT(~D10,200,~D36) 

3. Strict field-limits are enforced. Any expression that 
will not fit into its appropriate field will generate 
an error message and cause a Q error. Thus: 

L1BPT (10,200,-1) will cause an error. (The correct effect 
is generated with: L1BPT (10,200).) 

Also, note that in those macros that generate global byte-pointers, 
section values and address values must always be specified as distinct 
arguments. If address symbol FOO resolves to 377,, 123456 , then it 
would be specified in the macros as follows: 

G2BPT(F00_»~D18,7,F00&777777,36) 
Or (better) : 

FOOSEC=FOO_-~D18 

FOOADR=FOO&777777 

G2BPT(FOOSEC,7 ,FOOADR,3 6) 

If runtime-generated values are needed, then any or all argument 
fields may be assembled as zero and filled in at runtime using an 
appropriate DPB instruction. (G1BPT will not allow a zero bytesize 
and will only allow a zero byte position if it is legal for that 
particular bytesize.) 
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1-word local byte pointer 

! P ! S ! ! I ! X ! ADDR ! 

!0 516 11! 12! 13114 17118 35! 



Macro to generate local, 1-word byte pointers 
Args : 

BSIZ Byte size 

ADDR 18-bit address (indexing or indirection 
may be specified) 

BPOS Optional byte position 

Generates Q errors on the following: 

Bits 0-12 non-zero in ADDR 

BSIZ or BPOS greater than 6 bits 

DEFINE L1BPT (BSIZ , ADDR , BPOS) 

<.BSIZ.=BSIZ ;;Convert args to numeric 

.BPOS.=BPOS 

. .ERR.=0 ;;Reset error flag 

IFN <<ADDR>&<~0<777740, ,0>>>, 

<MPRNTX(LlBPT,Bits 0-12 non-zero in address field: ADDR; 

. .ERR.=1 

> 
IFN <.BSIZ.&<~0<-1, ,777700>>>, 

<MPRNTX(LlBPT f Bytesize greater than 6 bits: BSIZ) 

. .ERR.=1 

> 
IFN <.BP0S.&<~0<-1, ,777700>>>, 

<MPRNTX(LlBPT,Byte offset greater than 6 bits: BPOS) 

. .ERR.=1 

> 
; ;Cause Q error 
IFN <. .ERR.> ,<-l,-l,-l> 
; ;Generate byte pointer 
IFE <. .ERR.> , 

<IFIDN <BP0S>O,<P0INT .BSIZ.,ADDR> 

IFDIF <BPOS><> ,<POINT . BSIZ ., ADDR, . BPOS . > 

> 
PURGE . .ERR. , .BSIZ ., .BPOS. 
> 
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1-word global byte pointer 

! P,S ! SEC ! ADDR ! 

!0 5!6 17! 35! 



Macro to generate global, 1-word byte pointers 
Args : 

SEC 12-bit section address 

BSIZ Byte size 

ADDR 18-bit address (NO! ! indexing or indirection 

may be specified) 
BPOS Optional byte position 

Generates Q errors on following: 

Illegal byte size or byte position 
Indirection or indexing specified with ADDR 
ADDR greater than 18 bits 
SEC greater than 12 bits 

;Legal sizes and positions are as follows: 

Size Positions (Octal) 

6 44,36,30,22,14,6,0 

7 44,35,26,17,10,1 

8 44,34,24,14,4 

9 44,33,22,11,0 
18 44,22,0 
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DEFINE G1BPT (SEC , BSIZ , ADDR , BPOS< "04 4> ) 

<..ERR.=0 ; ;Reset error flag 

. .ENC.=0 ; ;Def ine it as an arbitrary value 

IFE BSIZ-7, ;;IF BYTESIZE=7 

<..ENC.=~057 ; ;Get correct encode value 

IFN BPOS-~044,<IFN BPOS-"03 5 , <IFN BPOS-~026 , <IFN BP0S-~017 , < IFN BPOS-~O10, 

<IFN BPOS-K. . ERR.=. .ERR. ! 1 >>>>>> 
> 
IFN BSIZ-7, ;;ELSE IF BYTESIZE=6 

<IFE BSIZ-6, 

< . . ENC.="045 ; ;Get correct encode value 

IFN BPOS-~044,<IFN BPOS-~036 , < IFN BPOS-"O30 , <IFN BPOS-"022 , < IFN BP0S-~014, 

<IFN BP0S-6,<IFN BPOS ,<.. ERR .=. ERR. ! 1> >>>>>> 
> 
IFN BSIZ-6, ;;ELSE IF BYTESIZE=8 

<IFE BSIZ-"O10, 

<..ENC.=~O50 ; ;Get correct encode value 

IFN BPOS-"044,<IFN BP0S-~03 4 , <IFN BPOS-~024 , <IFN BP0S-~01 4 , < IFN BPOS-4, 

<. .ERR. = . ERR. ! 1>>>>> 
> 
IFN BSIZ-~O10, ;;ELSE IF BYTESIZE=9 

<IFE BSIZ-~011, 

<..ENC.=~062 ; ;Get correct encode value 

IFN BPOS-~044,<IFN BP0S-~03 3 , < IFN BP0S-~02 2 , <I FN BP0S~~01 1 , <IFN BPOS , 

<• ,ERR.=. .ERR. ! 1>>>>> 
> 
IFN BSIZ-~011, ;;ELSE IF BYTESIZE=18 

<IFE BSIZ-"022, 

< . . ENC .="054 ; ;Get correct encode value 

IFN BSIZ-~044,<IFN BSI Z-~02 2< I FN BSI Z , < . . ERR . = . . ERE . ! 1> >> 
> 
IFN BSIZ-"022,<. .ERR.=. .ERR. ! 2> ;;ELSE: Illegal byte size 
> 
> 
> 
> 
IFN <<ADDR>&<-1, ,0>>,<. .ERR.=. .ERR. !4> ;;Address greater than 18 bits 

;; or indexing or indirection specified 
IFN <<SEC>&<~0<-1, ,770000>>>,<. .ERR.=. .ERR. ! <~O20>> ;;Section greater than 12 bits 
IFN . .ERR. , 

<IFN . .ERR.&1,<MPRNTX (G1BPT , I 1 legal byte offset: BPOS) > 
IFN . .ERR.&2,<MPRNTX (G1BPT , 1 1 legal byte size: BSIZ)> 
IFN ..ERR.&4, 

<MPRNTX (GlBPT,<Address indexed, indirect, or greater than 18 bits: ADDR> ) > 
IFN . .ERR.&<~020> ,<MPRNTX (G1BPT , Sec t ion greater than 12 bits: SEC)> 
-1,-1,-1 ;, 'Cause a "Q" error 

> 
; ;Generate the byte pointer 
IFE ..ERR., 

<<<. . ENC.+<<BSIZ>-<<BPOS>/<BSIZ>>>>_<~O36>>!<<ADDR>&<0 , ,-l>> ! < <SEC>_~0<2 2>>> 
PURGE . .ERR. , . .ENC. 
> 
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2-word local byte pointer 
!0 5!6 11! 12! 13 



17 ! li 



35! 



! 1 



Reserved ! 



Available to User 
ADDR 



!l!0! Reserved 
!0!1!2 12 



I ! X ! 
13114 17!li 



35! 



Macro to generate local, 2-word byte pointers 
Args : 

BSIZ Byte size 

ADDR 18-bit address (Indexing or indirection 

may be specified) 
BPOS Optional byte position 
OPT Optional user field available in word 1, right half 

Generates Q errors on the following: 

Bits 0-12 non-zero in ADDR 

Bits 0-17 non-zero in OPT 

BSIZ or BPOS greater than 6 bits 

DEFINE L2BPT(BSIZ , ADDR , BPOS , OPT<0> ) 
<..ERR.=0 ;;Reset error flag 

.BSIZ.=BSIZ ; ;Convert args to numeric 

.BPOS.=BPOS 
IFN <<ADDR>&<TO<777740, ,0>>>, 

<MPRNTX(L2BPT,Bits 0-12 non-zero in address field: ADDR) 

. .ERR.=1 

> 
IFN <<0PT>S:<-1, ,0>> , 

<MPRNTX(L2BPT,Bits 0-17 non-zero in optional field: OPT) 

. .ERR.=1 

> 
IFN <.BSIZ..&<~0<-1, ,777700>>>„ 

<MPRNTX(L2BPT,Bytesize greater than 6 bits: BSIZ) 

. .ERR.=1 

> 
IFN <.BP0S..&<~0<-1, ,777700>>>, 

<MPRNTX(L2BPT,Byte offset greater than 6 bits: BPOS) 

. .ERR.=1 

> 
IFN . .ERR. , <-l ,-1 ,-l> ;;Generate Q error 

; ;Generate the byte pointer 
IFE . .ERR. , 

<IFDIF <BPOSX>,<<<POINT .BSIZ . ,OPT, . BPOS . > ! 1B1 2>& < ~O<777740 , ,-l>>> 

IFIDN <BPOS><>, <<<POINT . BS IZ . ,OPT> ! 1B1 2> S < "0<7 77740 ,,- 1> >> 
<1BO!<<~0<400037, ,-l>>&<ADDR>>> ;, -Generate LFIW 

> 
PURGE . .ERR. , .BSIZ.. , .BPOS. 
> 
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2-word global byte pointer 

!0 5!6 111 12! 13 1711: 



35 



! P ! S ! 1 ! Reserved ! 
•0! I ! X ! SEC ! 
!0! 1 !2 5!6 17 1 



Available to User 
ADDR 



35 



Macro to generate global, 2-word byte pointers 
Args : 

SEC 12-bit section address 

BSIZ Byte size 

ADDR 18-bit address (Indexing or indirection 
may be specified) 

BPOS Optional byte position 

OPT Optional user field available in word 1, right half 

Generates Q errors on the following: 

SEC greater than 12 bits 

Bits 0-12 non-zero in ADDR 

Bits 0-17 non-zero in OPT 

BSIZ or BPOS greater than 6 bits 

DEFINE G2BPT( SEC, BSIZ , ADDR , BPOS ,OPT<0 > ) 
<..ERR.=0 ;;Reset error flag 

,BSIZ.=BSIZ ; ;Convert args to numeric 

.BPOS.=BPOS 
IFN <<SEC>&<~0<-1, ,770000>>>, 

<MPRNTX(G2BPT, Section greater than 12 bits: SEC) 

. .ERR.=1 

> 
IFN <<ADDR>&<~0<777740, ,0>>>, 

<MPRNTX(G2BPT,Bits 0-12 non-zero in address field: ADDR) 

. .ERR.=1 

> 
IFN <<0PT>&<-1, ,0>>, 

<MPRNTX(G2BPT,Bits 0-17 non-zero in optional field: OPT) 

. .ERR.=1 

> 
IFN <.BSIZ.&<~0<-1, ,777700>>>, 

<MPRNTX(G2BPT,Bytesize greater than 6 bits: BSIZ) 

. .ERR.=1 

> 
IFN <.BP0S.&<~0<-1, ,777700>>>, 

<MPRNTX(G2BPT,Byte offset greater than 6 bits: BPOS) 

. .ERR.=1 

> 
IFN . .ERR. ,<-l,-l ,-l> ;, -Generate Q error 

;;Generate the byte pointer 
IFE . .ERR. , 

<IFDIF <BPOSX>,<<<POINT .BSIZ. ,OPT, . BPOS .>! 1B1 2>& < ~0<7 777 4 , ,-l>>> 

IFIDN <BPOSX>,<<<POINT . BSIZ . ,OPT> ! 1B1 2>& <~O<777740 , ,-l> >> 
; ;Generate GFIW 
<<<ADDR> _< "01 4>>&<~0<3 700 00, ,0>>! <<ADDR>&<0, ,-l>>! < <SEC>_< "02 2> >> 

> 
PURGE . .ERR. , .BSIZ ., .BPOS. 
> 
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LIT 

IFN REL,< 
.RLEND==: .-1 

> 
IF2,<PURGE REL> 

.XCMSY 

END 



MAKE SURE LITERALS COME BEFORE END MARK 
MARK END OF CODE IN MACREL 
FLUSH REL FROM UNIV FILE 



;End of MACSYM 
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;<5.UTILITIES>ACTSYM.MAC2, 28-Oct-81 14:37:54, EDIT BY GRANT 
;Change major version to 5 

UNIVERSAL ACTSYM - DECsystem-1 0/20 symbol file for accounting V2(35) 
SUBTTL B.A. HUIZ ENGA/BAH/TAH/DPM 22-Jul-81 



; VERSION INFORMATION 
ACCVER==5 
ACCEDT==35 
ACCMIN==0 
ACCWHO==0 



MAJOR VERSION 
EDIT LEVEL 
MINOR VERSION 
LAST MODIFIER 



COPYRIGHT (C) 1979,1980,1981 BY 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 

IFNDEF FTUUOS,<FTUUOS==0> ; TOPS- 10 
IFNDEF FTJSYS,<FTJSYS==-1> ;TOPS-20 

DEFINE TOPS10,<IFN FTUUOS , > 
DEFINE TOPS20,<IFN FTJSYS,> 

IF1,< 

TOPS10 <PRINTX [Assembling ACTSYM-10]> 

TOPS20 <PRINTX [Assembling ACTSYM-20] > 
> 
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SUBTTL PARAMETERS FOR USAGE ITEM DESCRIPTORS 



; FIELDS IN DATA ITEM DESCRIPTOR 



US%FLG==:77B5 


US%IMM==:1B0 


US%TYP==:77B11 


.USASC== 





.USSIX== 


1 


.USOCT== 


2 


•USDEC== 


3 


.USDAT== 


4 


.USTAB== 


5 


.USVER== 


6 


.USSPC== 


7 


.USPDT== 


10 



FLAGS 
1 - IMMEDIATE DATA ITEM 
- ADDRESS OF DATA ITEM 

TYPE CODE 

ASCII 

SIXBIT 

OCTAL 

DECIMAL 

DATE-TIME 

TABLE (SPECIAL FORM) 

VERSION NUMBER 

SPACE FILL 

OLD STYLE TOPS-10 DATE/TIME 



US%LEN==:777B20 
US%COD==:77777B35 



; LENGTH 
;ITEM CODE 



; RECORD TYPE CODES 


RADIX 10 


.UTRST== 


1 


.UTSEN== 


2 


.UTCKP== 


3 


.UTUSB== 


4 


.UTTAD== 


5 


.UTBAT== 


6 


.UTINP== 


7 


.UTOUT== 


8 


.UTFLU== 


9 


.UTDSU== 


10 


.UTMNT== 


11 


.UTMMT== 


12 


.UTDMT== 


13 


.UTFCM== 


14 


.UTRET== 


15 


.UTARC== 


16 


.UTMIG== 


17 


•UTCOL== 


18 


.UTUSR==: 5000 


I 


RADIX 8 



.**** NOTE RADIX 10 **** 

SYSTEM RESTART ENTRY 

SESSION ENTRY 

CHECKPOINT ENTRY (SYSTEM RESTART) 

FIRST ENTRY OF USAGE FILE (SAME AS .UTRST) 

DATE-TIME CHANGE 

BATCH PROCESSOR 

INPUT SPOOLER ENTRY 

OUTPUT SPOOLER ENTRY 

FILE USAGE DIRECTORY ENTRY 

DISK SPINDLE USAGE ENTRY 

STRUCTURE MOUNT ENTRY 

TAPE MOUNT ENTRY 

DECtape MOUNT ENTRY 

FILE COMMAND ENTRY 

File retrieved 

File archived 

File migrated 

File collected 

;USER-DEFINED ENTRY TYPES ARE 5000-9999 
.**** END OF RADIX 10 **** 
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COMMENT 



The format of the data to be passed to the accounting system will 
consist of a list of items describing the entries in a single record. 

The record descriptor list will have a header containing the record 
type code and the record version information. 



Format of a record descriptor 



DEC ver. ! CUST ver. ! 
Flags ! Type ! Length 



Entry Type 
Item Code 



Data or Address (-1 for default) 



(Marks end of list) 



The generation of these tables will be controlled by the UITEM. 
macro. All known data items will have a name generated by the use of 
this macro. If any application dependent items are needed the UITEM. 
macro may be used to generate the new item. The USENT. macro may be 
used to generate the first word of the entry descriptor table. 

All USAGE entry headers and the system-defined USAGE entry types use 
the specific item types and these items are ordered by the system. 
Installation-defined USAGE entries (with entry types above .UTUSR 
5000 to 9999) use the arbitrary data items (USUAS., USUSX., USUDC . , 
USUOC, USUVR. , USUDT. , and USUSP.) in the order in which they are to 
be written into the USAGE entry record. Each arbitrary data record 
must be preceded by a USUAR. item. 

Example of installation-defined USAGE entry: 

The following code writes a USAGE entry for a fictitious "file access count" 
in a user program. This program must be running as an enabled OPERATOR or 
WHEEL. 

;Here to write USAGE entry for file access count 



MOVEI Tl, .USENT 
MOVEI T2,FILRDB 
USAGE 

ERJMP USGERR 
JRST USGOK 



;USAGE function to write entry 

;Address of Record Descriptor Block 

;Write the entry 

;Failed to write entry-- do something else 

;Entry written-- go on 



;Record descriptor block for file access count accounting 

FILRDB: 

USENT. ( .UTUSR+12,1,1) ;Entry type 5012= file access count. 
USPVR. (<BYTE(3)VWHO(9) VMAJOR(6) VMINOR ( 1 8 ) VEDIT> ,US%IMM) ; Version 

; of this program (for header record). 

USUAR. ;Start of first arbitrary record. 

USUAS. ([ASCII \This appears in every entry\],,27) ;Text. 
USUSP. (,,5) ;Space fill, 5 characters. 
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USUSP. (,,5) ;Space fill, 5 characters. 

USUDC. (FILCNT,,6) ;Count of file accesses, 000000-999999 

USUAR. ;Start of second arbitrary record. 

USUSX. (<SIXBIT \FILE: \> , US%IMM , 6 ) ;SIXBIT text for filename. 

USUAS. (FILNAM, ,200) ;File name, 200 characters. 

EXP ;End of entry. 

;Storage 

FILCNT: BLOCK 1 ;File access count 

FILNAM: BLOCK ~D<200/5> ;File name text 

& ',',', End of comment 
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SUBTTL UITEM. / USENT. / USAGE. DEFINITIONS 
SALL 

DEFINE UITEM. (NAME , TYPE , LEN) < 

DEFINE US'NAME'. (DATA<-1> , IMMED<0 > , ULEN<LEN> ) < 
USAGE. ( .US' NAME, ULEN, TYPE, IMMED , <DATA> ) 

> 
> 

DEFINE USENT. ( ETYPE , DVER , CVER) < 

BYTE (9) ~D<DVER> ,~D<CVER> (18) ~D<ETYPE> 
> 

DEFINE USAGE. (CODE , LENGTH , TYPE , FLAGS , DATUM) < 
FLAGS+<TYPE>B11+<~D<LENGTH>>B2 0+CODE 

IFB <DATUM>,<-1> 

IFNB <DATUM>,<DATUM> 
> 

DEFINE USDSK. (TABLE) < 

USAGE. ( .USDST,0 , . USTAB ,US% IMM , <TABLE> ) 
> 
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SUBTTL USAGE. ITEM-CODE DEFINITIONS 



DEFINE USLIST < 



DEFUS 


[JNO 


0, 


USDEC, 4) 


DEFUS 


TAD 


1, 


USDAT,14) 


DEFUS 


TRM 


2, 


USASC, 1) 


DEFUS 


LNO 


3, 


USOCT,4) 


DEFUS 


PNM 


4, 


USSIX,6) 


DEFUS 


PVR 


5, 


USVER, 15) 


DEFUS 


AMV 


6, 


USVER, 15) 


DEFUS 


NOD 


7 , 


USSIX, 6) 


DEFUS 


PPN 


10 


.USOCT 


12) 


DEFUS 


NM1 


11 


.USSIX 


6) 


DEFUS 


SNM 


12 


.USASC 


39) 


DEFUS 


MVR 


13 


.USVER 


15) 


DEFUS 


MBD 


14 


.USDAT 


14) 


DEFUS 


MUP 


15 


.USDEC 


,18) 


DEFUS 


ACT 


16 


.USASC 


39) 


DEFUS 


LCK 


17 


.USDAT 


14) 


DEFUS 


RTM 


20 


.USDEC 


9) 


DEFUS 


CTI 


21 


.USDEC 


11) 


DEFUS 


SST 


22 


, .USDAT 


14) 


DEFUS 


JTY 


23 


•USDEC 


1) 


DEFUS 


BJN 


24 


.USSIX 


6) 


DEFUS 


BSN 


25 


.USDEC 


6) 


DEFUS 


COM 


26 


.USASC 


39) 


DEFUS 


DKR 


27 


.USDEC 


8) 


DEFUS 


DKW 


30 


.USDEC 


8) 


DEFUS 


VTI 


31 


•USDEC 


11) 


DEFUS 


EBX 


32 


.USDEC 


9) 


DEFUS 


MBX 


33 


.USDEC 


r9) 


DEFUS 


MCL 


34 


.USDEC 


6) 


DEFUS 


MCM 


35 


.USDEC 


6) 


DEFUS 


SCL 


36 


•USDEC 


3) 


DEFUS 


TYI 


37 


.USDEC 


6) 


DEFUS 


TYO 


40 


.USDEC 


6) 


DEFUS 


TYW 


41 


•USDEC 


6) 


DEFUS 


CPN 


42 


•USDEC 


1) 


DEFUS 


CPO 


43 


.USDEC 


r4) 


DEFUS 


CP1 


44 


, .USDEC 


r4) 


DEFUS 


CP2 


45 


.USDEC 


4) 


DEFUS 


CP3 


46 


.USDEC 


4) 


DEFUS 


CP4 


47 


.USDEC 


r4) 


DEFUS 


CP5 


50 


.USDEC 


r4) 


DEFUS 


RQQ 


51 


.USDEC 


rH) 


DEFUS 


NM2 


52 


.USASC 


r39) 


DEFUS 


CCT 


53 


.USDEC 


7) 


DEFUS 


DTL 


54 


, .USDAT 


-14) 



JOB NUMBER 

CURRENT DATE/TIME 

TERMINAL DESIGNATOR 

LINE NUMBER 

PROGRAM NAME (CALLER) 

PROGRAM VERSION 

ACCOUNTING MODULE VERSION 

CALLER'S LOCATION 

PROJECT / PROGRAMMER NUMBER (TOPS10 ONLY] 

NAME OF USER (TOPS10) 

SYSTEM NAME 

MONITOR VERSION NUMBER 

MONITOR BUILD DATE 

MONITOR UPTIME (IN SECONDS) 

ACCOUNT STRING 

TIME OF LAST CHECKPOINT 

RUNTIME IN MS 

CORE-TIME INTEGRAL (TOPS10 ONLY) 

SESSION START TIME 

JOB TYPE (BATCH / TIMESHARING) 

BATCH JOB NAME 

BATCH SEQUENCE NUMBER 

USER COMMENT 

DISK READS 

DISK WRITES 

VIRTUAL CORE-TIME INTEGRAL 

EBOX MEGACOUNTS (CYCLES * 10*6) 

MBOX .MEGACOUNTS (CYCLES * 10*6) 

MONITOR CALLS 

MONITOR COMMANDS 

SCHEDULING CLASS 

TTY INPUT CHARACTERS 

TTY OUTPUT CHARACTERS 

TTY WAKEUPS 

NUMBER OF CPUS 

SERIAL NUMBER OF CPU0 

SERIAL NUMBER OF CPUl 

SERIAL NUMBER OF CPU2 

SERIAL NUMBER OF CPU3 

SERIAL NUMBER OF CPU4 

SERIAL NUMBER OF CPU5 

RUN QUEUE QUOTIENT (TOPS10 ONLY) 

NAME OF USER (TOPS20) 

CONSOLE CONNECT TIME (SECONDS) 

DATE/TIME BEFORE CHANGE (STAD) 
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;DISK UTILIZATION RECORD ENTRIES 



DEFUS 


NRF 


55 


.USDEC 


3) 


DEFUS 


TAL, 


56 


.USDEC 


10) 


DEFUS 


TUS 


57 


•USDEC 


10) 


DEFUS 


TNF 


60 


•USDEC 


5) 


DEFUS 


STR 


61, 


•USASC 


6) 


DEFUS 


STP 


62 


•USDEC 


1) 


DEFUS 


KTP 


63 


•USDEC 


3) 


DEFUS 


DTP 


64 


•USDEC 


3) 


DEFUS 


LIQ 


65 


•USDEC 


,6) 


DEFUS 


LOQ 


66 


.USDEC 


6) 


DEFUS 


LLI 


67 


•USDAT 


14) 


DEFUS 


(LAT 


,70 


•USDAT 


,14) 


DEFUS 


f EXP 


71 


, .USASC 


,1) 


DEFUS 


(DIR 


72 


, .USASC 


,39) 


DEFUS 


ALC 


r73 


.USDEC 


,10) 


DEFUS 


USG 


,74 


.USDEC 


,10) 


DEFUS 


(FIL 


,75 


.USDEC 


,5) 


DEFUS 


FON 


76 


.USASC 


,D 



NUMBER OF RECORDS FOLLOWING 

TOTAL ALLOCATED STORAGE 

TOTAL STORAGE USED 

TOTAL NUMBER OF FILES 

STRUCTURE NAME 

STRUCTURE TYPE CODE 

CONTROLLER TYPE 

DEVICE TYPE 

LOGGED IN QUOTA 

LOGGED OUT QUOTA 

LAST LOGGED IN DATE/TIME 

LAST DISK ACCOUNTING DATE/TIME 

EXPIRED DIRECTORY (Y/N) 

DIRECTORY NAME 

ALLOCATED STORAGE 

STORAGE USED 

NUMBER OF FILES 

FILES ONLY INDICATOR (Y/N) 



; SPOOLER INFORMATION RECORD ENTRIES 



DEFUS 


SRT, 


77,. 


USDEC, 9) 


DEFUS 


SCI, 


100, 


.USDEC 


11) 


DEFUS 


SDR, 


101, 


.USDEC 


8) 


DEFUS 


SDW 


102, 


.USDEC 


,8) 


DEFUS 


JNM 


103, 


.USSIX 


6) 


DEFUS 


QNM 


104, 


.USSIX 


3) 


DEFUS 


SDV 


105, 


•USSIX 


6) 


DEFUS 


SSN 


106, 


.USDEC 


,6) 


DEFUS 


SUN 


107, 


.USDEC 


,6) 


DEFUS 


CRT 


110, 


.USDAT 


,14) 


DEFUS 


DSP, 


111, 


.USSIX 


,6) 


DEFUS 


TXT, 


112, 


.USASC 


,39) 


DEFUS 


PRI, 


113, 


•USDEC 


,2) 


DEFUS 


SNF 


114, 


•USDEC 


,5) 


DEFUS 


SCD, 


115, 


•USDAT 


,14) 


DEFUS 


FRM 


116, 


•USSIX 


,6) 



SPOOLER RUNTIME 

CORE-TIME INTEGRAL 

SPOOLER DISK READS 

SPOOLER DISK WRITES 

JOB NAME 

QUEUE NAME 

PROCESSING DEVICE 

SEQUENCE NUMBER 

SPOOLER UNITS PROCESSED 

CREATION DATE/TIME OF REQUEST 

DISPOSITION 

OPR OR SYSTEM TEXT 

PRIORITY 

NUMBER OF FILES PROCESSED 

SCHEDULED DATE/TIME 

FORMS TYPE 



; DATE/TIME CHANGE RECORD ENTIRES 



DEFUS (OFD, 117, .USDEC, 7) 
DEFUS (OFS, 120, .USDEC, 7) 
DEFUS (ODT, 121, .USDAT, 14 



OFFSET IN DAYS 
OFFSET IN SECONDS 
OLD DATE/TIME 



; ARBITRARY RECORD ITEM TYPES 



DEFUS (UAR,122, .USSPC,0) 

DEFUS (UAS, 123, .USASC, 0) 

DEFUS (USX, 124, .USSIX, 0) 

DEFUS (UOC,125, .USOCT,0) 

DEFUS (UDC, 126, .USDEC, 0) 

DEFUS (UDT, 127, .USDAT, 14) 

DEFUS (UVR,130, .USVER,15) 

DEFUS (USP,131, .USSPC,0) 



USER-DEFINED ARBITRARY RECORD DELIMITER 
USER-DEFINED ASCII STRING 
USER-DEFINED SIXBIT STRING 
USER-DEFINED OCTAL NUMBER 
USER-DEFINED DECIMAL NUMBER 
USER-DEFINED DATE AND TIME 
USER-DEFINED VERSION (STANDARD FORMAT) 
USER-DEFINED SPACE FILL 



; STRUCTURE MOUNT RECORD ENTRIES 



DEFUS (SSI, 132, .USSIX, 6) 
DEFUS (TNP, 133, .USDEC, 2) 
DEFUS (SRV, 134, .USDAT, 14) 



SIXBIT STRUCTURE ID 
TOTAL NUMBER OF PACKS 
SERVICED DATE/TIME OF REQUEST 
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DEFUS (MCT,135, .USDEC,3) 
DEFUS (DCT,136, .USDEC, 3) 
DEFUS (ATP, 137, .USDEC,1) 

;TAPE MOUNT RECORD ENTRIES 



MOUNT COUNT BEFORE MOUNT 
MOUNT COUNT AFTER DISMOUNT 
ACCESS TYPE 



DEFUS 


VID, 


140, 


.USSIX 


6) 


DEFUS 


VSN, 


141, 


.USSIX 


6) 


DEFUS 


MRF 


142, 


.USDEC 


r8) 


DEFUS 


MWF 


143, 


•USDEC 


r8) 


DEFUS 


MLT, 


144, 


.USDEC 


2) 


DEFUS 


MLS 


145, 


.USDEC 


rD 


DEFUS 


MRD, 


146, 


.USDEC 


8) 


DEFUS 


MWR, 


147, 


.USDEC 


,8) 


DEFUS 


FSI, 


150, 


.USSIX 


6) 


DEFUS 


SRE 


151, 


.USDEC 


,10) 


DEFUS 


SWE 


152, 


.USDEC 


,10) 


DEFUS 


HRE 


153, 


.USDEC 


,10) 


DEFUS 


HWE 


154, 


.USDEC 


,10) 



MAGTAPE VOLUME LABEL IN VOL1 LABEL 

VISUAL SERIAL NUMBER 

THOUSANDS OF FRAMES READ 

THOUSANDS OF FRAMES WRITTEN 

LABEL TYPE 

VOLUME LABEL STATE 

NUMBER OF PHYSICAL RECORDS READ 

NUMBER OF PHYSICAL RECORDS WRITTEN 

FILE SET IDENTIFIER 

NUMBER OF SOFT READ ERRORS 

NUMBER OF SOFT WRITE ERRORS 

NUMBER OF HARD READ ERRORS 

NUMBER OF HARD WRITE ERRORS 
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Re tri eve/archive/migration /col lection entries 



DEFUS (TP1,155, 

DEFUS (TS1,156, 

DEFUS (TF1,157, 

DEFUS (TP2,160, 

DEFUS (TS2,161, 

DEFUS (TF2,162, 

DEFUS (RSN,163, 

DEFUS (EUT,164, 



• USSIX, 6) 
.USDEC,4) 
•USDEC, 6) 
•USSIX, 6) 
.USDEC,4) 
•USDEC, 6) 
•USOCT,l) 
.USDEC,7) 



Tape ID 1 

Tape saveset # 

Tape file # 

Tape 2 ID 

Tape saveset # 

Tape file # 

Reason offline code 

ELAPSED USE TIME (STRUCTURE AND TAPE) 



; BATCH PROCESSOR RECORD ENTRIES 



DEFUS 


BAC 


165, 


•USASC 


39) 


DEFUS 


BRN, 


166, 


.USDEC 


9) 


DEFUS 


BCT 


167 


.USDEC 


,11) 


DEFUS 


BDR 


170, 


.USDEC 


8) 


DEFUS 


BDW 


171, 


.USDEC 


8) 


DEFUS 


BJB 


172 


.USSIX 


6) 


DEFUS 


BSQ, 


173 


.USDEC 


6) 


DEFUS 


BDT, 


174, 


.USDAT 


14) 


DEFUS 


BET, 


175 


•USDAT 


,14) 


DEFUS 


BST 


176 


•USDAT 


14) 


DEFUS 


BDS 


177, 


.USSIX 


6) 


DEFUS 


BTX 


200 


•USASC 


r39) 


DEFUS 


BPR 


201 


•USDEC 


,2) 


DEFUS 


URE 


202 


•USDEC 


r6) 


DEFUS 


UAC 


,203 


•USDEC 


,6) 


DEFUS 


UCE 


204 


•USDEC 


,4) 


DEFUS 


UCH 


205 


•USDEC 


,4) 


DEFUS 


RIN 


206 


, .USDEC 


,6) 



BATCH ACCOUNT STRING 

BATCH RUNTIME 

BATCH CORE-TIME INTEGRAL 

BATCH DISK READS 

BATCH DISK WRITES 

JOB NAME 

SEQUENCE NUMBER 

CREATION DATE/TIME OF REQUEST 

DATE/TIME JOB COULD BE SCHEDULED 

DATE/TIME JOB STARTED RUNNING 

DISPOSTITION 

TEXT 

PRIORITY OF REQUEST 

USER'S RUNTIME ESTIMATE 

USER'S ACTUAL RUNTIME 

USER'S CORE ESTIMATE 

USER'S CORE HIGHWATER MARK 

REQUEST ID NUMBER 



; INPUT SPOOLER RECORD ENTRIES 



DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 

DEFUS 
DEFUS 
DEFUS 
DEFUS 



IAC, 
IRN, 
ICT, 
IDR, 
IDW, 
UN, 
IQN, 
IPD, 
ISN, 
ICR, 
ICD, 
IDS, 
ITX, 
I PR, 
IRI, 
ICN, 



207 
210 
211 
212 
213 
214 
215 
216 
217 
220 
221 
222 
223 
224 
225 
226 



OAC,227 
ORI,230 
OCN,231 
DPN,232 



USASC 
USDEC 
,USDEC 
.USDEC 
,USDEC 
■USSIX 
.USSIX 
.USSIX 
.USDEC 
.USDEC 
■USDAT 
.USSIX 
.USASC 
■USDEC 
.USDEC 
.USDEC 



,39) 

,9) 

,11) 

,8) 

,8) 

,6) 

,3) 

,6) 

,6) 

,6) 

,14) 

,6) 

,39) 

,2) 

,6) 

,7) 



USASC, 39; 
USDEC, 6) 
USDEC, 7) 
USASC, 39' 



INPUT SPOOLER ACCOUNT STRING 

INPUT SPOOLER RUNTIME 

INPUT SPOOLER CORE-TIME INTERAL 

INPUT SPOOLER DISK READS 

INPUT SPOOLER DISK WRITES 

INPUT SPOOLER JOB NAME 

INPUT SPOOLER QUEUE NAME 

INPUT SPOOLER PROCESSING DEVICE 

INPUT SPOOLER SEQUENCE NUMBER 

INPUT SPOOLER NUMBER OF CARDS READ 

CREATION DATE/TIME OF PEQUEST 

DISPOSITION 

TEXT 

PRIORITY OF REQUEST 

REQUEST ID NUMBER 

CONNECT TIME 

OUTPUT SPOOLER ACCOUNT STRING 
OUTPUT SPOOLER REQUEST ID NUMBER 
OUTPUT SPOOLER CONNECT TIME 
DISK USAGE DIRECTORY PPN 



DISK USAGE ACCOUNT STRING RECORD - (DUA) 



DEFUS 
DEFUS 
DEFUS 
DEFUS 



(DAC,233, 
(DPP, 232, 
(DFN,233, 
(DFS,234, 



USASC, 39) 
USASC, 39) 
USDEC, 5) 
USSIX, 6) 



DUA - ACCOUNT STRING 

DUA - PPN/DIRECTORY 

DUA - NUMBER OF FILES 

DUA - FILE STRUCTURE NAME 
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DEFUS (DFT,235, .USDEC, 1) 
DEFUS (DKT, 236, .USDEC,3) 
DEFUS (DDT, 237, .USDEC,3) 



;DUA - FILE STRUCTURE TYPE 
;DUA - CONTROLLER TYPE 
;DUA - DEVICE TYPE 



;DISK SPINDLE USAGE RECORD 



DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 



(SFS 
(SFT 
(SCT 
(SDT 
(SPI 
(SDU 
(SNP 
(SMN 
(DTF 
(DCC 



,240, 
,241, 
,242, 
,243, 
,244, 
,245, 
,246, 
,247, 
,250, 
,251, 



.USSIX,6) 
.USDEC,1) 
.USDEC,3) 
.USDEC, 3) 
.USASC,12) 
.USSIX,4) 
.USDEC, 2) 
.USDEC, 2) 
.USDAT,14) 
.USDEC, 7) 



FILE STRUCTURE NAME 

TYPE OF FILE STRUCTURE 

CONTROLLER TYPE 

DEVICE TYPE 

DISK PACK IDENTIFIER 

DISK UNIT NAME 

TOTAL NUMBER OF PACKS IN STRUCTURE 

M OF N PACK COUNT 

DATE/TIME OF FIRST MOUNT 

CONNECT TIME 



;USER FILE STRUCTURE MOUNT RECORD (CONT.) 



DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 
DEFUS 



(FMA, 
(FST, 
(FCT, 
(FDT, 
(FDS, 
(FOT, 
(FCD, 
(FSD, 
(FCO, 



252, 
254, 
255, 
256, 
257, 
260, 
261, 
262, 
263, 



.USASC,39) 
.USDEC, 1) 
.USDEC, 3) 
•USDEC, 3) 
.USSIX,6) 
.USASC, 39) 
.USDAT,14) 
.USDAT,14) 
.USDEC, 7) 



;USER MAGTAPE MOUNT RECORD 



DEFUS 


(MAC 


264, 


.USASC 


39) 


DEFUS 


(MDS 


265, 


.USSIX 


,6) 


DEFUS 


(MTX 


266, 


•USASC 


,39) 


DEFUS 


(MCD 


267, 


.USDAT 


,14) 


DEFUS 


(MSD 


270, 


.USDAT 


,14) 


DEFUS 


(MVD 


271, 


.USDAT 


,14) 


DEFUS 


(MCO 


272, 


.USDEC 


,3) 


DEFUS 


(MCN 


273, 


.USDEC 


,7) 


;USER 


DECTAPE MOUNT RI 


:cof 


DEFUS 


(DAN 


274, 


.USASC 


,39) 


DEFUS 


(DVI 


275, 


.USSIX 


,6) 


DEFUS 


(DRI 


276, 


.USSIX 


6) 


DEFUS 


(DTR 


277, 


.USDEC 


,8) 


DEFUS 


(DTW 


300, 


.USDEC 


,8) 


DEFUS 


(DDS 


301, 


.USSIX 


,6) 


DEFUS 


(DTX 


302, 


.USASC 


,39) 


DEFUS 


(DCE 


303, 


•USDAT 


,14) 


DEFUS 


(DSQ, 


304, 


.USDAT 


14) 


DEFUS 


(DSS 


305, 


.USDAT 


14) 


DEFUS 


(DCN 


306, 


.USDEC 


7) 



ACCOUNT STRING 

TYPE OF FILE STRUCTURE 

CONTROLLER TYPE 

DEVICE TYPE 

DISPOSITION 

TEXT 

CREATION DATE/TIME OF REQUEST 

SCHEDULED DATE/TIME OF REQUEST 

CONNECT TIME 



ACCOUNT STRING 

DISPOSITION 

TEXT 

CREATION DATE/TIME OF REQUEST 

SCHEDULED DATE/TIME OF REQUEST 

SERVICED DATE/TIME OF REQUEST 

TYPE OF CONTROLLER 

CONNECT TIME 



ACCOUNT STRING 

DECTAPE VOLUME IDENTIFIER 

DECTAPE REEL IDENTIFIER 

DECTAPE READS 

DECTAPE WRITES 

DISPOSTITION 

TEXT 

CREATION DATE/TIME OF REQUEST 

SCHEDULED DATE/TIME OF REQUEST 

SERVICED DATE/TIME OF REQUEST 

CONNECT TIME 



;USER DECTAPE FILE COMMAND RECORD 



DEFUS (FAS, 307, .USASC, 39) 

DEFUS (FMR, 310, .USDEC, 9) 

DEFUS (FCI, 311, .USDEC, 11) 

DEFUS (FDR, 312, .USDEC, 8) 

DEFUS (FDW, 313, .USDEC, 8) 

DEFUS (FCM, 314, .USASC, 1) 

DEFUS (FNF, 315, .USDEC, 2) 



ACCOUNT STRING 

MOUNT RUNTIME TO PROCESS USER REQUEST 

MOUNT CORE-TIME INTEGRAL 

MOUNT DISK READS 

MOUNT DISK WRITES 

TYPE OF FILE COMMAND 

NUMBER OF FILES TRANSFERRED 
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DEFUS (FDP,316, .USSIX, 6) 

DEFUS (FTX,317, .USASC,39) 

DEFUS (FCQ,320, .USDAT,14) 

DEFUS (FSH,321, .USDAT,14) 

DEFUS (FVD,322, .USDAT,14) 

DEFUS (FCE,323, .USDEC,7) 



DISPOSITION 

TEXT 

CREATION DATE/TIME OF REQUEST 

SCHEDULED DATE/TIME OF REQUEST 

SERVICED DATE/TIME OF REQUEST 

CONNECT TIME 



;LATE COMERS 

DEFUS (NM3, 324, .USSIX, 6) 

DEFUS (B27,325, .USSPC,27) 



DEFUS (SID, 326, .USSIX, 6) 

DEFUS (B06,327, .USSPC,6) 

DEFUS (UPF, 330, .USSIX, 1) 

DEFUS (FPF, 331, .USSIX, 1) 

DEFUS (TMA, 332, .USSIX,!) 



DEFUS (LLG,333, .USPDT,14 
DEFUS (DVN, 334, .USSIX, 6) 



TOPS-10 - 2ND HALF OF USER NAME 

(#11 IS 1ST HALF) 
SPACE FILL 27 CHARACTERS USED IN TOPS10 TO 

USE INSTEAD OF PPN/DIRECTORY DEFUSES. THE 

DEFUS PPN IS USED IN CONJUNCTION WITH 

THIS ONE. 
TOPS-10 - DISK PACK ID (USED INSTEAD OF #244) 
SPACE FILL 6 CHARACTERS (USED WITH #326 ABOVE) 
TOPS-10 DISK USAGE - UFD WAS PROTECTED 
TOPS-10 DISK USAGE - SOME FILES WERE PROTECTEL 
TOPS-10 DISK USAGE - USER HAS TOO MANY AUNIQUE 
ACCOUNT STRINGS IN DIRECTORY. LIMIT IS DEFINE 
IN IPCF MESSAGE FOR DISK USAGE FROM BACKUP 
TOPS-10 OLD FORMAT DATE/TIME OF LAST LOGIN 
TOPS-10 DEVICE NAME (MAG/DECTAPE MOUNTS) 



>; ; ; END OF USLIST 
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SUBTTL Macros to define all USAGE, item codes 



TOPS 10 < 

DEFINE UITEM. (NAME , TYPE , LEN) < 

DEFINE US' NAME'. (DATA<-1> , IMMED<0> ) < 

USAGE . (.US' NAME , TYPE , IMMED , <DATA> ) 

> 
> 

DEFINE USAGE. (CODE , TYPE , FLAGS , DATUM) < 
IFN TYPE-.USASC,<LENGTH==1> 
IFE TYPE-.USASC,<LENGTH==10 

IFL FLAGS, <PRINTX ?ASCII DATA CANNOT BE IMMEDIATE>> 
IFB <DATUM>,< 
QA.IMM+<LENGTH>B17+CODE 
EXP -1 
> 
IFNB <DATUM>,< 

IFL FLAGS, < 

CA.IMM+<LENGTH>B17+CODE 

DATUM> 

IFGE FLAGS, <IFIDN <DATUM><-1>,< 

IFE LENGTH-10,<PRINTX 7CANNOT BE DEFAULTED> 

QA.IMM+<LENGTH>B17+C0DE 

DATUM> 

IFDIF <DATUM><-1>,< 

<LENGTH>B17+CODE 

<DATUM>&<37, ,777777>> 
> 
> 
> 

DEFINE USENT. ( ETYPE , DVER , CVER , LRESP , RESP) < 

FLAGS==0 

IFNB <LRESP>,<IFG LRESP , <FLAGS==QF . RSP> > 

FLAGS+.QUMAE 



LRESP, ,RESP 

QA. IMM+<1>B17+.QBAFN 

UGENT$ 

QA.IMM+<1>B17+.QBAET 

ETYPE 
> 

> ;END OF TOPS-10 CONDITIONAL 



DEFINE DEFUS (NAM , VAL , TYP , LEN) < 
IF1,<IFDEF .US'NAM,< 

PRINTX .US'NAM ALREADY DEFINED 
>> 

.US'NAM==:VAL 
UITEM. (NAM, TYP, LEN) 
> 



D-13 



ACTSYM 

; EXPAND ALL DEFINITIONS 

USLIST 

;SPECIAL ITEM TYPE CODE DEFINITIONS 

.USDSX==:7776 ; STRUCTURE/DIRECTORY INFO WORD (SPECIAL) 

.USDST==:7777 ;DISK STATISTICS TABLE POINTER 
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SUBTTL TOPS-10 IPCF message definitions and formats 



TOPS 10 < ; START OF A LONG CONDITIONAL 



FTCASECONVERT== : 



LOWER/UPPER CONVERSION SELECTION FEATURE TEST 

= DON'T CONVERT 
-1 =CONVERT LOWER CASE LETTERS TO UPPER CASE 



PRJWPB==4 00 



;SET LOGICAL BLOCK SIZE IN PROJCT.SYS TO 2 DISK 



PRJWPB==<PRJWPB+177>&777600 ; ROUND UP TO NEXT FULL DISK BLOCK 



IPCF TYPES OF MESSAGES SENT TO THE ACCOUNTING DAEMON, ACTDAE. 
THESE ARE THE ACCOUNTING SUBFUNCTION VALUES TO STORE IN 
OF THE QUEUE. UUO. SEE UUOSYM.MAC. 



QBAFN 



UGVAL$: 
UGLGN$ = 
UGSES$ = 
UGATT$ = 
UGSDT$= 
UGVAC$ = 

UGENT$ = 
UGEBC$= 
UGUFC$ = 
UGFDM$= 
UGFDD$ = 
UGMGM$= 
UGMGD$= 
UGDTM$= 
UGDTD$= 
UGSPM$= 
UGSPD$ = 
UGACK$ = 
UGDUE$= 
UGACC$ = 
UGOUP$ = 



1 
2 
3 
4 
5 
6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 



UGLGO$==:27 



VALIDATION MESSAGES 

LOGIN MESSAGES (USER IS LOGGING IN) 

SESSION MESSAGES (USER TYPED A SESSION COMMAND] 

ATTACH MESSAGES 

SET DATE/TIME EVENT FROM DAEMON 

RESPONSE TO ANY MESSAGE IF REQUESTED 

(??$ACK IS NON-ZERO) 
MAKE AN ENTRY 
END A BILLING CLOSURE 
USAGE FILE CLOSURE 

USER FILE STRUCTURE MOUNT MESSAGE 
USER FILE STRUCTURE DISMOUNT MESSAGE 
USER MAGTAPE MOUNT MESSAGE 
USER MAGTAPE DISMOUNT MESSAGE 
USER DECTAPE MOUNT MESSAGE 
USER DECTAPE DISMOUNT MESSAGE 
DISK PACK SPINDLE SPIN-UP MESSAGE 
DISK PACK SPINDLE SPIN-DOWN MESSAGE 
GENERAL ACK CODE 
DISK USAGE FROM BACKUP 
ACCESS CONTROL 
OBTAIN USER PROFILE 
26 = UNUSED 
MONITOR LOGOUT MESSAGE (.IPCSL) 



; SUCCESSFUL/UNSUCCESSFUL IPCF MESSAGE CODES 



UGTRU$==:1 
UGFAL$==:2 



; SUCCESSFUL MESSAGE 
; FAILURE MESSAGE 
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; FORMAT OF LOGIN MESSAGE (UGLGN$) 



UL$TYP= 
UL$ACK= 
UL$LIN= 
UL$PRG= 
UL$VER= 
UL$NOD= 
UL$ACT= 
UL$ACE= 
UL$BEG= 
UL$JTY= 



UL$BNM= 
UL$BSQ= 
UL$RMK = 
UL$RME = 
UL$CLS = 
UL$PPN= 
UL$NM1 = 
UL$NM2= 
UL$BRI = 
UL$TDE = 





UL$TYP+1 
UL$ACK+1 
UL$LIN+1 
UL$PRG+1 
UL$VER+1 
UL$NOD+l 
UL$ACT+7 
UL$ACE+1 
UL$BEG+1 
ULJTI$==:1 
ULJBA$==:2 
UL$JTY+1 
UL$BNM+1 
UL$BSQ+1 
UL$RMK+7 
UL$RME+1 
UL$CLS+1 
UL$PPN+1 
UL$NM1+1 
UL$NM2+1 
UL$BRI+1 



TYPE OF MESSAGE 

UNIQUE MESSAGE IDENTIFIER 

LINE NUMBER 

PROGRAM NAME (ALWAYS LOGIN) 

VERSION OF LOGIN 

NODE NAME 

USER'S ACCOUNT STRING 

END OF ACCOUNT STRING 

SESSION START DATE/TIME 

JOB TYPE 

TIMESHARING 

BATCH 

BATCH JOB NAME 

BATCH SEQUENCE NUMBER 

SESSION REMARK 

END OF SESSION REMARK 

SCHEDULING CLASS 

PROJECT-PROGRAMMER NUMBER OF USER 

FIRST SIX LETTERS OF USER'S NAME 

LAST SIX LETTERS OF USER'S NAME 

BATCH REQUEST ID 

TERMINAL DESIGNATOR 



; FORMAT OF SESSION MESSAGE (UGSES$) 



US$TYP== 
US$ACK== 
US$PRG== 
US$VER== 
US$ACT== 
US$ACE== 
US$BEG== 
US$RMK== 
US$RME=: 





US$TYP+1 

US$ACK+1 

US$PRG+1 

US$VER+1 

US$ACT+7 

US$ACE+1 

US$BEG+1 

US$RMK+7 



TYPE OF MESSAGE 

UNIQUE MESSAGE IDENTIFIER 

PROGRAM NAME (ALWAYS LOGIN; 

VERSION OF LOGIN 

USER'S NEW ACCOUNT STRING 

END OF ACCOUNT STRING 

SESSION START DATE/TIME 

NEW SESSION REMARK 

END OF SESSION REMARK 



; FORMAT OF ATTACH MESSAGES (UGATT$) 



UA$TYP== 
UA$ACK== 
UA$LIN== 
UA$PRG== 
UA$VER== 
UA$NOD== 
UA$TDE== 
UA$TJN== 





UA$TYP+1 

UA$ACK+1 

UA$LIN+1 

UA$PRG+1 

UA$VER+1 

UA$NOD+l 

UA$TDE+1 



TYPE OF MESSAGE 

UNIQUE MESSAGE IDENTIFIER 

LINE NUMBER 

PROGRAM NAME (ALWAYS LOGIN; 

VERSION LOGIN 

NODE NAME 

TERMINAL DESIGNATOR 

TARGET JOB NUMBER 
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FORMAT OF THE REQUEST FOR VALIDATION MESSAGE (UGVAL$) 

THIS MESSAGE CAN BE EITHER IPCF OR QUEUE. UUO FORMAT. THE SAMPLE 
PROGRAM "VALID" SHOWS AN EXAMPLE FOR USING QUEUE. FOR VALIDATION. 



UV$TYP== 
UV$ACK=: 

UV$PPN== 
UV$ACT== 



:0 

:1 

:2 

:3 



UV$ACE==:UV$ACT+7 



TYPE OF MESSAGE 

GIVEN TO US TO RETURN TO THE REQUESTOR OF 

VALIDATION 
PPN TO VALIDATE 
BEGINNING OF ACCOUNT STRING TO VALIDATE 

(MAX. OF 8 WORDS) 
LAST WORD OF THE ACCOUNT STRING 



; FORMAT OF THE ANSWER TO A MESSAGE (UGVAC$) 



UC$TYP== 
UC$RES== 
UC$ACK== 
UC$ERR== 
UC$ACT== 
UC$ACE== 





1 

2 

3 

UC$ERR 

UC$ACT+7 



TYPE OF MESSAGE 

RESPONSE — EITHER UGTRU$ OR UGFAL$ 

CODE TO RETURN TO THE REQUESTOR OF VALIDATION 

BEGINNING OF ASCIZ ERROR MESSAGE 

ACCOUNT STRING RETURNED IF VALIDATION SUCCESS 

LAST WORD OF THE ACCOUNT STRING 



; FORMAT OF THE SET DATE/TIME EVENT MESSAGE FROM DAEMON (UGSDT$) 



UD$TYP== 
UD$OFF== 
UD$ODT== 
UD$PRG== 



UD$VER==:4 



TYPE OF MESSAGE 

TIME OFFSET OF COMMAND 

OLD DATE/TIME 

NAME OF PROGRAM SENDING MESSAGE 

(DAEMON) 
VERSION OF PROGRAM SENDING MESSAGE 

(DAEMON VERSION #) 



;FORMAT OF "MAKE AN ENTRY" MESSAGE (UGENT$). 



THIS MESSAGE IS ONLY GENERATED VIA THE QUEUE 
"USRENT" FOR AN EXAMPLE OF IT'S USE. 



UUO. SEE SAMPLE PROGRAM 
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; FORMAT OF THE FIRST THREE WORDS OF ALL MOUNT AND DISMOUNT MESSAGES TO 
: CONFORM TO GALAXY-TYPE HEADER. 



UX$TYP==0 
UX$FLG==1 
UX$COD==2 



TYPE OF MESSAGE 
FLAGS WORD 
ACK CODE 



; FORMAT OF A USER FILE STRUCTURE MOUNT MESSAGE - UGFDM$ 



UF$DEV== 
UF$JOB== 
UF$TRD== 
UF$TNO== 
UF$PNM== 
UF$PVR== 
UF$NOD== 
UF$ACT== 
UF$ACE== 
UF$PPN== 
UF$NM1== 
UF$NM2== 
UF$STY== 
UF$PNO== 
UF$CTY== 
UF$DTY== 
UF$DSP== 
UF$TXT== 
UF$CDT== 
UF$SDT== 
UF$VDT== 
UF$CBR== 
UF$ACC== 



UX$COD+l 

UF$DEV+1 

UF$JOB+l 

UF$TRD+1 

UF$TNO+l 

UF$PNM+1 

UF$PVR+1 

UF$NOD+l 

UF$ACT+7 

UF$ACE+1 

UF$PPN+1 

UF$NM1+1 

UF$NM2+1 

UF$STY+1 

UF$PNO+l 

UF$CTY+1 

UF$DTY+1 

UF$DSP+1 

UF$TXT+10 

UF$CDT+1 

UF$SDT+1 

UF$VDT+1 

UF$CBR+1 



DEVICE NAME IN SIXBIT 

JOB NUMBER OF USER 

TERMINAL DESIGNATOR 

LINE NUMBER 

NAME OF PROGRAM (USUALLY PULSAR) 

VERSION OF PROGRAM (USUALLY PULSAR) 

NODE NAME OF USER'S LOCATION 

USER'S ACCOUNT STRING 

END OF ACCOUNT STRING 

PROJECT-PROGRAMMER NUMBER OF USER 

FIRST SIX LETTER OF USER'S NAME 

LAST SIX LETTERS OF USER'S NAME 

TYPE OF FILE STRUCTURE 

NUMBER OF PACKS IN FILE STRUCTURE 

CONTROLLER TYPE 

DEVICE TYPE 

DISPOSITION 

TEXT TO EXPLAIN DISPOSITION 

CREATION DATE/TIME OF MOUNT REQUEST 

SCHEDULED DATE/TIME OF MOUNT REQUEST 

SERVICED DATE/TIME OF MOUNT REQUEST 

MOUNT COUNT BEFORE REQUEST 

ACCESS TYPE 



;FORMAT OF USER FILE STRUCTURE DISMOUNT MESSAGE (UGFDD$). 
; IS APPENDED TO THE MOUNT MESSAGE. 



THE FOLLOWING 



UF$SCT==:UF$ACC+1 



; MOUNT COUNT AFTER DISMOUNT 
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; FORMAT OF USER MAGTAPE MOUNT MESSAGE - UGMGM$ 



UM$DEV== 
UM$JOB== 
UM$TRD== 
UM$TNO== 
UM$PNM== 
UM$PVR== 
UM$NOD== 
UM$ACT== 
UM$ACE== 
UM$PPN== 
UM$NM1== 
UM$NM2== 
UM$CTY== 
UM$DSP== 
UM$TXT== 
UM$CDT== 
UM$SDT== 
UM$VDT== 
UM$VID== 
UM$RID== 
UM$LTY== 
UM$LST== 
UM$FSI== 



UX$COD+l 

UM$DEV+1 

UM$JOB+l 

UM$TRD+1 

UM$TNO+l 

UM$PNM+1 

UM$PVR+1 

UM$NOD+l 

UM$ACT+7 

UM$ACE+1 

UM$PPN+1 

UM$NM1+1 

UM$NM2+1 

UM$CTY+1 

UM$DSP+1 

UM$TXT+10 

UM$CDT+1 

UM$SDT+1 

UM$VDT+1 

UM$VID+1 

UM$RID+1 

UM$LTY+1 

UM$LST+1 



DEVICE NAME IN SIXBIT 

JOB NUMBER OF USER 

TERMINAL DESIGNATOR 

LINE NUMBER 

NAME OF PROGRAM (USUALLY PULSAR) 

VERSION OF PROGRAM (USUALLY PULSAR) 

NODE NAME OF USER'S LOCATION 

ACCOUNT STRING 

END OF ACCOUNT STRING 

PROJECT-PROGRAMMER NUMBER OF USER 

FIRST SIX LETTERS OF USER'S NAME 

LAST SIX LETTERS OF USER'S NAME 

CONTROLLER TYPE 

DISPOSITION 

TEXT TO EXPLAIN DISPOSITION 

CREATION DATE/TIME OF MOUNT REQUEST 

SCHEDULED DATE/TIME OF MOUNT REQUEST 

SERVICED DATE/TIME OF MOUNT REQUEST 

VOLUME ID RECORDED IN VOL1 LABEL 

REEL ID VISUAL LABEL OF TAPE 

LABEL TYPE 

VOLUME LABEL STATE 

FILE SET IDENTIFIER 



;FORMAT OF A USER MAGTAPE DISMOUNT MESSAGE (UGMGD$). 
APPENDED TO THE MOUNT MESSAGE. 



THE FOLLOWING IS 



UM$MRD=: 
UM$MWR=: 
UM$RRD=- 
UM$RWR== 
UM$SRE=- 
UM$SWE=: 
UM$HRE== 
UM$HWE=: 



UM$FSI+1 
UM$MRD+1 
UM$MWR+1 
UM$RRD+1 
UM$RWR+1 
UM$SRE+1 
UM$SWE+1 
UM$HRE+1 



MAGTAPE READS - THOUSANDS OF CHARACTERS 
MAGTAPE WRITES - THOUSANDS OF CHARACTERS 
PHYSICAL RECORDS READ 
PHYSICAL RECORDS WRITTEN 
SOFT READ ERRORS 
SOFT WRITE ERRORS 
HARD READ ERRORS 
HARD WRITE ERRORS 
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; FORMAT OF A USER DECTAPE MOUNT MESSAGE - UGDTM$ 



UD$DEV== 
UD$JOB== 
UD$TRD== 
UD$TNO== 
UD$PNM== 
UD$PVR== 
UD$NOD== 
UD$ACT== 
UD$ACE== 
UD$PPN== 
UD$NM1== 
UD$NM2== 
UD$DSP== 
UD$TXT== 
UD$CDT== 
UD$SDT== 
UD$VDT== 
UD$VID== 
UD$RID== 



UX$COD+l 

UD$DEV+1 

UD$JOB+l 

UD$TRD+1 

UD$TNO+l 

UD$PNM+1 

UD$PVR+1 

UD$NOD+l 

UD$ACT+7 

UD$ACE+1 

UD$PPN+1 

UD$NM1+1 

UD$NM2+1 

UD$DSP+1 

UD$TXT+10 

UD$CDT+1 

UD$SDT+1 

UD$VDT+1 

UD$VID+1 



DEVICE NAME IN SIXBIT 

JOB NUMBER OF USER 

TERMINAL DESIGNATOR 

LINE NUMBER 

NAME OF PROGRAM (USUALLY PULSAR) 

VERSION OF PROGRAM (USUALLY PULSAR) 

NODE NAME OF USER'S LOCATION 

ACCOUNT STRING 

END OF ACCOUNT STRING 

PROJECT-PROGRAMMER NUMBER OF USER 

FIRST SIX LETTERS OF USER'S NAME 

LAST SIX LETTERS OF USER'S NAME 

DISPOSITION 

TEXT TO EXPLAIN DISPOSITION 

CREATION DATE/TIME OF MOUNT REQUEST 

SCHEDULED DATE/TIME OF MOUNT REQUEST 

SERVICED DATE/TIME OF MOUNT REQUEST 

VOLUME ID RECORDED ON DECTAPE 

REEL ID VISUAL LABEL OF DECTAPE 



; FORMAT OF A USER DECTAPE DISMOUNT MESSAGE (UGDTD$). 
TO THE MOUNT MESSAGE. 



THE FOLLOWING IS APPENDE 



UD$DRD==:UD$RTD+1 
UD$DWR== : UD$DRD+1 



; DECTAPE READS - BLOCKS 
; DECTAPE WRITES - BLOCKS 
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; FORMAT OF A DISK SPINDLE SPIN-UP MESSAGE - UGSPM$ 



JS$DEV== 
JS$JOB== 
JS$TRD== 
US$TNO== 
US$PNM== 
JS$PVR== 
JS$NOD== 
US$FSN== 
US$STY== 
US$CTY== 
US$DTY== 
US$DPI== 
US$PNO== 
US$MTH== 
US$DTM== 



UX$COD+l 
US$DEV+1 
US$JOB+l 
US$TRD+1 
US$TNO+l 
US$PNM+1 
US$PVR+1 
US$NOD+l 
US$FSN+1 
US$STY+1 
US$CTY+1 
US$DTY+1 
US$DPI+1 
US$PNO+l 
US$MTH+1 



DISK UNIT NAME IN SIXBIT 

JOB NUMBER OF PULSAR 

TERMINAL DESIGNATOR 

LINE NUMBER 

NAME OF PROGRAM (USUALLY PULSAR) 

VERSION OF PROGRAM (USUALLY PULSAR) 

NODE NAME OF PULSAR'S LOCATION 

FILE STRUCTURE NAME 

FILE STRUCTURE TYPE 

CONTROLLER TYPE 

DEVICE TYPE 

DISK PACK IDENTIFIER 

NUMBER OF PACKS IN FILE STRUCTURE 

M OF N COUNT 

DATE/TIME PACK WAS SPUN UP 



; FORMAT OF A DISK SPINDLE SPIN-DOWN MESSAGE (UGSPD$) IS THE SAME AS A MOUNT MESSAGE 
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; FORMAT OF A DISK USAGE ENTRY FROM BACKUP - UGDUE$ 



UB$ACN== 
UB$JOB== 
UB$TRD== 
UB$TNO== 
UB$NOD== 
UB$PNM== 
UB$PVR== 
UB$TAU== 
UB$TWU== 
UB$TNF== 
UB$FSN== 
UB$PPN== 
UB$FST== 
UB$CNT== 
UB$DVT== 
UB$QIN== 
UB$QOU== 
UB$LLG=; 
UB$LAT== 
UB$EXP== 
UB$UPF== 
UB$FPF== 
UB$ABO== 



UX$COD+l 
UB$ACN+1 
UB$JOB+l 
UB$TRD+1 
UB$TNO+l 
UB$NOD+l 
UB$PNM+1 
UB$PVR+1 
UB$TAU+1 
UB$TWU+1 
UB$TNF+1 
UB$FSN+1 
UB$PPN+1 
UB$FST+1 
UB$CNT+1 
UB$DVT+1 
UB$QIN+1 
UB$QOU+l 
UB$LLG+1 
UB$LAT+1 
UB$EXP+1 
UB$UPF+1 
UB$FPF+1 



NUMBER OF ACCOUNT STRINGS 

JOB NUMBER OF BACKUP 

TERMINAL DESIGNATOR 

TERMINAL NUMBER 

NODE NAME 

PROGRAM NAME (BACKUP) 

PROGRAM VERSION NUMBER 

TOTAL ALLOCATED DISK USAGE 

TOTAL WRITTEN DISK USAGE 

TOTAL NUMBER OF FILES 

FILE STRUCTURE NAME 

PPN 

FILE STRUCTURE TYPE 

CONTROLLER TYPE 

DEVICE TYPE 

LOGGED IN QUOTA 

LOGGED OUT QUOTA 

LAST LOGIN DATA/TIME (OLD FORMAT) 

LAST ACCOUNTING DATE/TIME 

EXPIRED DIRECTORY FLAG 

UFD WAS PROTECTED FLAG 

SOME FILES WERE PROTECTED FLAG 

ACCOUNT STRING BUFFER OVERFLOWED 



;THE FOLLOWING 4 ITEMS ARE REPEATED FOR EACH ACCOUNT STRING IN THE UFD 



UB$ACT== 
UB$BAL== 
UB$BWR== 
UB$NFL== 



UB$ABO+l 
UB$ACT+10 
UB$BAL+1 
UB$BWR+1 



ACCOUNT STRING 

BLOCKS ALLOCATED TO THIS ACCOUNT STRING 

BLOCKS WRITTEN 

FILE WITH THIS ACCOUNT STRING 



UB$END==:UB$NFL+1 



; LENGTH OF THE IPCF MESSAGE (NOT REALLY) 



; COMPUTE THE MAXIMUM NUMBER OF ACCOUNTS STRINGS THAT CAN BE PASSED IN THIS 
IPCF FORMAT. ONLY 1 IPCF MESSAGE CAN BE USED SO THIS IS IT. 

UB$MAC==:<100 0-UB$ACT>/<UB$END-UB$ACT> 
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; FORMAT OF A REQUEST FOR ACCESS CONTROL VALIDATION. 

; THIS MESSAGE IS ONLY AVAILABLE VIA THE QUEUE. UUO. THE SYMBOLS DEFINED 
BELOW ARE USED AS THE DATA ITEM DESCRIPTORS FOR THE SUB-FUNCTION BLOCK. 
SEE THE SAMPLE PROGRAM "ACCCHK" FOR AN EXAMPLE OF IT'S USE. 



UGTYP==:0 

UG.VER==:0 
UG.SPV==:1 



UGACT== 
,UGPPN== 
UGPSW== 



TYPE OF ACCESS CHECK 

VERIFY PPN, PASSWORD, AND ACCOUNT STRING 

SPRINT VERIFY PPN, PASSWORD, AND ACCT STRING 

MORE FUNCTIONS LATER 

ACCOUNT STRING BLOCK 

PPN BLOCK 

PASSWORD BLOCK 
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SUBTTL TOPS-10 ACCT.SYS entry definitions 



;*** Note *** Still under TOPS-10 conditional 



.ACWRD==0 



; FIRST WORD OF THE FILE ACCT.SYS 



AC.VRS^=777777B17 
.ACCVN==4 

AC.LEN==777777B35 
. ACLEN==16 

; ACCT.SYS ENTRY FORMAT 



FORMAT VERSION NUMBER OF THE FILE 

CURRENT VERSION NUMBER 

LENGTH OF EACH ENTRY 

VERSION 4 IS 14(10) WORDS LONG 



ACPPN==0 

ACPSW==1 

ACPRV==2 

AC.IPC= 
AC.DSP= 
AC.MET= 
AC.POK= 
AC.CPU= 
AC.HPQ= 
AC.SPL= 
AC.RTT= 
AC.LOK= 
AC.TRP= 
AC.SPC= 
AC.SPM= 
AC.CUS- 

ACNM1==3 
,ACNM2==4 

ACLIT==5 

AC.WDH= 
AC.WEH= 

ACCIP==6 

AC.NPP= 
AC..NVP= 
AC.SND= 
AC.RCV= 



PROJECT PROGRAMMER NUMBER 

PASSWORD IN SIXBIT 

PRIVILEGED BITS 
=1B0 ;JOB CAN 
=3B2 ;HIGHEST 
==1B3 ;JOB CAN 
==1B4 ;JOB CAN 
:=1B5 ;JOB CAN 
=74B9 ;HIGHEST 
=1B10 ;JOB CAN 
==1B13 ;JOB CAN 
=1B14 ;JOB CAN 
:=1B15 ;JOB CAN 
: =1B16 ;JOB CAN 
:JOB CAN 



DO IPCF PRIVILEGED FUNCTIONS 

DISK PRIORITY 

DO METER UUO 

POKE THE MONITOR 

CHANGE ITS CPU SPECIFICATION 

HPQ THAT JOB CAN SET 

SET NO SPOOL 

DO REAL TIME TRAPPING (RTTRP.) 

DO LOCK UUO 

DO TRPSET UUO 

PEEK/SPY AT ALL OF CORE 

PEEK/SPY AT THE MONITOR 



UUO 



= = 1B17 

==777777B35 ;RESERVED FOR CUSTOMER 

USER'S NAME IN SIXBIT - FIRST WORD 
USER'S NAME IN SIXBIT - SECOND WORD 
TIMES ALLOWED TO LOGIN 

==77777777B23 ;WEEKDAY HOURS, 

:=7777B35 ;WEEKEND HOURS, 

;CORE AND IPCF PARAMETERS 



0000-2359 

2-HOUR SHIFTS 0000-2200 



; = 777B8 

=777B17 
: = 777B26 
-777B35 



MAXIMUM NUMBER OF PHYSICAL PAGES 

MAXIMUM NUMBER OF VIRTUAL PAGES 

MAXIMUM NUMBER OF SENDS 

MAXIMUM NUMBER OF RECEIVES 
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ACPR0==7 

AC.WDT= 
AC.WRT= 
AC . WWA= 
AC.RED= 
AC.WRI= 
AC.CDR= 
AC.CDP= 
AC.PTP= 
AC.PLT= 
AC.LPT= 
AC.WVR= 
AC.WMT= 
AC.WFL= 
AC.OPR= 



AC.RMK= 
AC.ACT= 
AC.LOC= 
AC.ROP= 
AC.DST= 
AC.RMT= 
AC.SBJ= 
AC.BAT= 
AC.NRT: 
AC.NRB= 
AC.PRT= 



; PROFILE 
= = 1B0 

= 1B1 

= 1B2 
= = 1B3 

= 1B4 

= 1B5 

= 1B6 

= 1B7 
= 1B8 
= 1B9 
= 1B10 
= 1B11 
= 1B12 
= 7B23 

.OBNOP==0 
.OBSDP==l 
•OBLOP==2 
.OBROP==3 
= = 1B24 
= = 1B25 
= = 1B26 



ACCUS= 
ACPGM= 
ACDEV= 
ACDIR= 
ACCNO= 
ACESE= 



AC.PRB= 

= 10 

= 11 

= 12 

= 13 

= 14 

= 15 
AC.EXP= 
AC.SCD= 
AC.EDQ: 



-1B27 
= = 1B28 
= 1B29 
= = 1B30 
= = 1B31 
= = 1B32 
= = 1B33 
= = 1B34 
= = 1B35 
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BITS 

WATCH DAYTIME 
WATCH RUNTIME 
WATCH WAIT 
WATCH READ 
WATCH WRITE 
SPOOL CDR 
SPOOL CDP 
SPOOL PTP 
SPOOL PLT 
SPOOL LPT 
WATCH VERSION 
WATCH MTA 
WATCH FILE 

OPERATOR PRIVILEGE FIELD (SEE UUOSYM FOR SYMBOLS; 
NO OPERATOR PRIVILEGES 
SYSTEM OPERATOR PRIVILEGES 
LOCAL OPERATOR PRIVILEGES 
REMOTE OPERATOR PRIVILEGES 
REMARK IS REQUIRED 
ACCOUNT IS REQUIRED 
USER MAY LOGIN AT LOCAL TERMINAL 

LOGIN AT REMOTE OPR OR CTY 

LOGIN AT DATA SET TERMINAL 

LOGIN AT REMOTE TERMINAL 

LOGIN SUB JOB OF A BATCH JOB 

LOGIN UNDER BATCH 
REQUIRED UNDER TIMESHARING 
REQUIRED UNDER BATCH 

REQUIRED FOR TIMESHARING 

REQUIRED FOR BATCH 



USER 

USER 

USER 

USER 

USER 

NAME 

NAME 

PASSWORD 

PASSWORD 



MAY 
MAY 
MAY 
MAY 
MAY 



CUSTOMER USER PROFILE BITS 

SIXBIT NAME OF PROGRAM TO RUN 

SIXBIT DEVICE FROM WHERE TO RUN PROGRAM 

DIRECTORY FORM WHERE TO RUN PROGRAM 

CHARGE NUMBER 

EXPIRATION DATE, /SCHEDULER AND END/DEQ PARAMETERS 



=777777B17 

=777B26 

=777B35 



EXPIRATION DATE 
SCHEDULER TYPE 
ENQ/DEQ/QUOTA 



> ;END OF TOPS-10 CONDITIONAL FROM WAY BACK 



END 



;END OF ACTSYM . MAC 
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+1 return, 1-10 
+2 return, 1-10 



18-bit address,, 1-3 
23-bit address,. 1-2 
30-bit address,. 1-3 



AC's, 1-1 
AC'S, 

Returning process, 3-338 

Setting process, 3-384 
ACCES JSYS, 3-2 
Access , 

Append, 2-8, 3-298 

Directory, 2-9, 3-2 

Execute, 2-8, 3-298 

Execute-only, 2-8 

File, 2-8, 3-298 

Gaining directory, 3-2 

Modes, 2-8 

Page, 3-355, 3-491 

Read, 2-8, 3-298 

Relinquishing directory, 
3-2 

Thawed, 2-8, 3-298 

Write, 2-8, 3-298 
Access control, 2-65, 3-157 
Access modes, 2-8 
Access-control, 

Functions, 2-65 
Access-control functions, 

2-65 
Access-control JSYS ' s , 

GETOK%, 3-157 

GIVOK%, 3-167 

RCVOK%, 3-330 
Access-control program, 

3-167, 3-416 
Accessibil ity , 

Setting page, 3-428 
Account , 

Changing, 3-38 

Returning file's, 3-144 

Returning job's, 3-143 
Accounting , 

Functions, 2-1 

System, 3-475 
Accounting functions, 2-1 
Accounting JSYS ' s , 

CACCT, 3-38 

GACCT, 3-143 

GACTF, 3-144 



Accounting JSYS's 
SACTF, 3-369 
USAGE, 3-475 
Accounts , 

Verifying, 3-4 
Accumulators, 1-1 
Acquiring physica 

3-309 
Activation , 

Interrupt chann 
ADBRK JSYS, 3-5 
Adding a table en 
Address, 1-7 
18-bit, 1-3 
23-bit, 1-2 
30-bit, 1-3 
global, 1-3 
Section-relativ 
Address breaks, 3 
Address global , 1 
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